> ## Documentation Index
> Fetch the complete documentation index at: https://portkey-docs-feature-comparison-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion MCP server

> The Notion MCP server enables AI agents to interact with Notion, a versatile workspace that combines note-taking, project management, knowledge bases, and relational databases. Through MCP, assistants can programmatically retrieve, search, and update pages, blocks, and databases—turning Notion into a live context source or task sink for AI workflows.

## **When should you use this server**

* Pull meeting notes or project trackers directly from Notion databases.
* Update tasks or write back summaries into shared workspaces.
* Search across blocks, pages, or databases to surface relevant knowledge.
* Automate repetitive workspace actions (create pages, append notes).

## **Key features**

* **Page & block interaction** — Retrieve, create, update, and delete pages and blocks (text, headings, todos, images).
* **Database operations** — Query databases with filters and sorts, fetch entries, and add new rows.
* **Content search** — Search for keywords or properties across an entire workspace.
* **User information** — Look up metadata about workspace members.
* **Workspace organization** — Understand nested page structure and database relationships.

## **Authentication**

* **Method:** OAuth2 via Notion integration.
* **Setup:** You install the Notion MCP integration into your workspace, select which pages/databases to share, and complete the OAuth flow.
* **Notes:** Minimum scopes are `read:content`, `update:content`, and `databases`; wider scopes may be needed for advanced actions.

## **Endpoints**

**Remote hosted MCP server (recommended):**
`https://mcp.notion.com/sse`

* Provides OAuth sign-in, token-efficient streaming, and optimized AI usage.

**Local MCP server (advanced):**\
Can be run with npm or Docker for offline or custom deployments:
`npx @notion/mcp-server`\
or
`docker run notion/mcp-server`

## **Setup & usage**

1. Create a Notion integration and note the client ID/secret.
2. Decide whether to connect via the **hosted remote server** (simplest, one-click OAuth) or run a **local server**.
3. Add the MCP server config to your client (Claude Desktop, VS Code, Portkey Gateway).
4. Complete OAuth flow (remote) or provide integration token (local).

***

## **Tools provided**

### **search**

Search across your Notion workspace and connected integrations (Slack, Google Drive, Jira). Falls back to basic workspace search if advanced AI features aren't available.

* **Use cases:**
  * *"Check Slack for how we solved this bug in the past."*
  * *"Search for documents mentioning 'budget approval process.'"*
  * *"Look for meeting notes from last week with John."*
  * *"Find all project pages that mention 'ready for dev.'"*

***

### **fetch**

Retrieve content from a Notion page or database by URL.

* **Use cases:**
  * *"What are the product requirements that still need to be implemented from this ticket [https://notion.so/page-url](https://notion.so/page-url)?"*

***

### **create-pages**

Create one or more Notion pages with specified properties and content. If no parent is given, a private page will be created.

* **Use cases:**
  * *"Create a project kickoff page under our Projects folder with agenda and team info."*
  * *"Make a new employee onboarding checklist in our HR database."*
  * *"Create a meeting notes page for today's standup with action items."*
  * *"Add a new product feature request to our feature database."*

***

### **update-page**

Update a page's properties or content.

* **Use cases:**
  * *"Change the status of this task from 'In Progress' to 'Complete.'"*
  * *"Add a new section about risks to the project plan page."*
  * *"Update the due date on this project to next Friday."*
  * *"Replace the old project timeline with the updated version."*

***

### **move-pages**

Move one or more pages or databases to a new parent.

* **Use cases:**
  * *"Move my weekly meeting notes page to the 'Team Meetings' page."*
  * *"Reorganize all project documents under the 'Active Projects' section."*

***

### **duplicate-page**

Duplicate a Notion page. Runs asynchronously.

* **Use cases:**
  * *"Duplicate my project template page so I can use it for the new Q3 initiative."*
  * *"Make a copy of the meeting agenda template for next week's planning session."*

***

### **create-database**

Create a new Notion database with specified properties.

* **Use cases:**
  * *"Create a new database to track customer feedback with fields for customer name, feedback type, priority, and status."*
  * *"Set up a content calendar database with publish date, content type, and approval status."*

***

### **update-database**

Update a database's properties, name, description, or other attributes.

* **Use cases:**
  * *"Add a status field to track project completion."*
  * *"Update the task database to include priority levels."*

***

### **create-comment**

Add a comment to a page.

* **Use cases:**
  * *"Add a feedback comment to this design proposal."*
  * *"Leave a note on the quarterly review page about budget concerns."*
  * *"Comment on the meeting notes to clarify action item deadlines."*
  * *"Add my thoughts to the product roadmap discussion."*

***

### **get-comments**

List all comments on a page, including threaded discussions.

* **Use cases:**
  * *"List comments on the project requirements section."*
  * *"Get all feedback comments from last week's review."*

***

### **get-users**

List all users in the workspace with details.

* **Use cases:**
  * *"Get contact details for the user who created this page."*
  * *"Look up the profile of the person assigned to this task."*

***

### **get-user**

Retrieve a user's details by ID.

* **Use cases:**
  * *"What's my email address?"*
  * *"What's my Notion user ID?"*

***

### **get-self**

Retrieve information about the current bot user and the workspace it's connected to.

* **Use cases:**
  * *"Which Notion workspace am I currently connected to?"*
  * *"What's my file size upload limit for the current workspace?"*

## **Notes**

* First, always verify you're connecting to Notion's official MCP endpoints:
  * [https://mcp.notion.com/mcp](https://mcp.notion.com/mcp) — Streamable HTTP protocol (Recommended)
  * [https://mcp.notion.com/sse](https://mcp.notion.com/sse) — Server-Sent Events (SSE) protocol

* When setting up workflows, carefully review the permissions and data access levels of each agent and MCP tool.

Source: [Notion MCP docs](https://developers.notion.com/docs/mcp)