notion-mcp-server
This repository is Notion's official local MCP server for the Notion API. You create an internal integration in Notion, connect the pages and databases it may access (or grant access page by page), and run the server with npx or Docker using the integration token. A read-only token is possible by giving the integration only the Read content capability.
Version 2.0 moved to the Notion API version 2025-09-03, where data sources replace databases as the main abstraction. Four database tools were replaced by data-source equivalents, two new tools were added (listing data source templates and moving pages), and the total is now 21 tools. Tools are discovered at startup, so clients pick up the new names automatically, but hard-coded prompts that name old tools need updating.
The README opens with an important note: Notion now offers a remote Notion MCP with OAuth sign-in and tools tuned for agents, it is prioritising and only actively supporting that remote server, this local repository may be sunset, and its issues and pull requests are not actively monitored. Our data shows the last push on 2026-09-20.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-09-20
- Commits, last 90 days
- 7
- Releases, last 90 days
- 0
- Latest release
- v2.1.0 (2026-01-31)
- Open issues
- 203
- Recent issues with at least one comment
- 8/20
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #106 401 using mcp.notion.com/mcp22 comments · 2025-08-11
- #69 Gemini-Cli reports an error with the Notion MCP21 comments · 2025-06-26
- #82 Parameter serialization bug: Object parameters received as strings in create-pages and move-pages tools18 comments · 2025-07-15
- #269 Internal Server Error on OAuth callback when connecting via Claude.ai (Hosted MCP)16 comments · 2026-04-16
- #191 Feature Request: Support local file upload for images and files14 comments · 2026-01-28
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Who it fits
- You want a local Notion server you run with npx or Docker, using an internal integration token.
- You want access limited to the pages and databases you connect to the integration, or a read-only token.
- Your prompts work with Notion API data sources: v2.0 has 21 tools on the 2025-09-03 API.
- You want the supported option: the README says Notion prioritises its remote Notion MCP and may sunset this repository.
- You need issues answered: the README says issues and pull requests here are not actively monitored.
- You do not want to manage tokens: the remote Notion MCP uses standard OAuth instead.
How it differs
vs pipeshub-ai★ 3.8kPipesHub indexes Notion with 50+ other sources for cited, permission-aware search. The Notion server reads and edits Notion pages and data sources directly.
Compatibility
Quick start
Use cases
Alternatives
Featured in these lists
Comments
No comments yet. Be the first!