Notion MCP server
Notion's hosted MCP server lets agents search, read, and write across your workspace over OAuth.
Notion MCP is Notion's official hosted server that exposes a workspace to AI agents. It is built around finding and reading content first: the agent can search across pages, databases, and connected tools, fetch a page or data source by URL or ID, then create and update pages, manage views, and read or post comments. Notion's hosted server converts content to Markdown and trims the response for token efficiency, so the model gets clean, agent-friendly text instead of raw API payloads.
The canonical setup is the remote endpoint at https://mcp.notion.com/mcp, connected over OAuth so each user authorizes their own workspace access without copying a token into a config file. That makes it a natural fit for team agents that need to answer questions over internal docs or keep a knowledge base current as work happens.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}claude mcp add --transport http notion https://mcp.notion.com/mcpHeads up
- First tool call opens a browser to authorize.
Available tools
| Tool | Description |
|---|---|
| notion-search | Searches across the Notion workspace and connected tools such as Slack, Google Drive, and Jira. |
| notion-fetch | Retrieves the content of a Notion page, database, or data source by URL or ID. |
| notion-create-pages | Creates one or more Notion pages with specified properties and content. |
| notion-update-page | Updates a Notion page's properties, content, icon, or cover. |
| notion-move-pages | Moves one or more pages or databases to a new parent. |
| notion-duplicate-page | Duplicates a Notion page within the workspace. |
| notion-create-database | Creates a new database with an initial data source and view. |
| notion-update-data-source | Updates a data source's name, description, or schema properties. |
| notion-create-view | Creates a new view on a database with a chosen view type. |
| notion-update-view | Updates a view's name, filters, sorts, or display configuration. |
| notion-query-data-sources | Queries across one or more data sources and returns structured summaries. |
| notion-query-database-view | Queries a database using a predefined view's filters and sorts. |
| notion-create-comment | Adds a comment to a page or specific block. |
| notion-get-comments | Lists all comments and discussions on a page. |
| notion-get-teams | Retrieves the teamspaces in the current workspace. |
| notion-get-users | Lists the users in the workspace with their details. |
| notion-get-user | Retrieves a single user's information by ID. |
| notion-get-self | Retrieves information about the authenticated bot user and its workspace. |
What you can do with it
Answer questions over internal docs
A team agent searches the workspace and returns sourced answers from existing pages instead of guessing or asking a human.
Keep a knowledge base current
As decisions are made, the agent creates or updates the relevant pages so the workspace stays in sync with reality.
FAQ
- Is it free?
- The MCP server is free to connect; it works within your existing Notion plan and its API limits.
- Does it support remote/OAuth?
- Yes. The canonical deployment is the remote endpoint at https://mcp.notion.com/mcp using OAuth, so each user authorizes their own workspace.