Notion MCP Server
Official local MCP server for the Notion API: search, read and edit pages as Markdown, and work with databases
- 4,686 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Modifies workspace pages and databases
- Exposes connected page content to the model
Install
- Works in
Manual install
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_****"
}
}
}
}The same snippet works in .cursor/mcp.json.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Modifies workspace pages and databases
- Exposes connected page content to the model
This is third-party code. Review the repository files before installing.
What it does
The server exposes the Notion API to the agent through an internal integration token. The agent can search pages and read and rewrite their content as Markdown, which saves tokens compared with block JSON. It can query data sources with filters and sorts, create and update data sources, use templates and move pages. Databases cannot be deleted through the server, and access can be narrowed to read-only in the integration settings.
Who it is for. For teams and individuals who keep docs, tasks and knowledge bases in Notion.
Good fit when
- You need to find and summarise information from a Notion knowledge base
- You need to update task statuses in a Notion database
- You need to generate a page from a template based on code or notes
Not a fit when
- You want a token-free setup: the remote Notion MCP with OAuth fits better
- The workspace holds data that must not be exposed to a model
Example request
Find the release plan page in Notion and append a section with today's meeting outcomesMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
NOTION_TOKENrequired, secret- Notion internal integration token
OPENAPI_MCP_HEADERSsecret- JSON with Authorization and Notion-Version headers instead of NOTION_TOKEN
Limitations
Notion focuses on its remote MCP server, and this repository gets little maintenance and may be sunset. You need an internal integration token and must share pages with the integration. Version 2.0 replaced database tools with data source tools. Notion availability from Russia is limited, so API access without VPN is not guaranteed.
How to disable. Remove the notionApi block from your MCP config and revoke the integration token in Notion settings.
FAQ
Why can't the agent see my pages?
Pages and databases must be connected to the integration in its Access tab or via the page menu.
Can I grant read-only access?
Yes, leave only the read content capability on the integration.
Discussion
No questions or reviews yet.
Related
MCP serversA Notion MCP server: the agent searches, reads, queries and updates workspace pages and databases
Notion MCP (awkoy)
Notion MCP Server (awkoy)
Notion MCP on a token: an agent searches pages, runs databases, edits blocks and comments through three tools and 47 operations, with no manual sign-in
Official Anytype MCP server: an agent searches, creates and edits objects, lists and types in your knowledge base
Obsidian MCP Server
obsidian-mcp-server
An MCP server for an Obsidian vault: read, search and precisely edit notes, sections, frontmatter and tags
Obsidian MCP
obsidian-mcp
A local MCP server for Obsidian vaults: reads and edits explicitly configured folders of Markdown files, Obsidian need not be open
An MCP server for an Obsidian vault via the Local REST API plugin: search, read, append and patch notes
Comparison with similar tools
Entries that share the main search query, and how they differ.
| Entry | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Notion MCP Server (this entry) | yes | API key | 4,686 | |
| Notion MCP (awkoy) | no | API key | 179 | notion MCP on a token |
| Notion Plugin for Claude Code | yes | 501 | the official Notion plugin for Claude Code |
README in short
The README warns that Notion's focus moved to the remote OAuth server. It covers version 2.0 changes and Markdown tools, step-by-step integration and page access setup, and npx and Docker configs for Cursor, Claude Desktop, Zed and Copilot CLI. There is a Streamable HTTP mode with a required bearer token. MIT licensed.