notion-mcp-server
notion-mcp-server is an MCP server, listed under project & docs. It reaches notion. It needs MCP_AUTH_TOKEN and NOTION_TOKEN to authenticate. Its repository has 178 GitHub stars and is licensed under MIT; we last read it on 2026-10-22.
This server connects AI agents like Claude, Cursor, ChatGPT, and Claude Desktop to Notion using the Model Context Protocol, enabling interaction with pages, databases, blocks, comments, and files.
Install
Read from notion-mcp-server’s own README, close to verbatim -- not written by us, and not guessed.
npx add-mcp notion-mcp-server --env NOTION_TOKEN=ntn_paste_your_token_here
What it reaches, and what it needs
What it connects to
Unverified means a mention in the server’s own description, not a citation. A wrong claim here costs nothing to correct and nothing to trust yet.
Maintenance
Notion MCP server with token auth: connect Claude Code, Claude Desktop, Cursor, VS Code and Codex to Notion pages, databases, comments and files. 3 tools, 94% less context than the official server, works on any plan, runs headless.
What notion-mcp-server can do
2 tools documented in its README. An AI client calls these by name.
notion_write- No description in the README.
notion_read- No description in the README.
Read from the README; names are kept only if the README contains them.
notion-mcp-server compared with similar servers
| Server | Reaches | Needs | Stars | Last update | Licence |
|---|---|---|---|---|---|
| notion-mcp-server (this page) | notion | MCP_AUTH_TOKEN, NOTION_TOKEN | 178 | 2026-10-21 | MIT |
| mcp-notion-server | notion(1 shared) | NOTION_API_TOKEN | 924 | 2026-07-31 | MIT |
| notion_mcp | notion(1 shared) | NOTION_API_KEY | 208 | 2024-12-18 | MIT |
| notion-mcp | notion(1 shared) | NOTION_TOKEN | 31 | 2025-09-30 | MIT |
| notion-api-mcp | notion(1 shared) | NOTION_API_KEY | 28 | 2025-01-14 | MIT |
| tablecharts-mcp-server | googlesheets, notion, salesforce, tablecharts(1 shared) | TABLECHARTS_API_KEY | 0 | 2026-07-04 | MIT |
Ranked by services in common with notion-mcp-server, then by stars. Figures are from each repository when we last read it.
Common questions about notion-mcp-server
- What does notion-mcp-server do?
- This server connects AI agents like Claude, Cursor, ChatGPT, and Claude Desktop to Notion using the Model Context Protocol, enabling interaction with pages, databases, blocks, comments, and files.
- How do I install notion-mcp-server?
- Its own README gives this command: npx add-mcp notion-mcp-server --env NOTION_TOKEN=ntn_paste_your_token_here. Run it where your MCP client can launch the server, and check the README for any settings it asks for.
- What does notion-mcp-server connect to, and what does it need?
- It reaches notion. The credentials we found in its source are MCP_AUTH_TOKEN and NOTION_TOKEN.
- Which AI clients can use notion-mcp-server?
- Its own description mentions Claude Desktop and Cursor. That is a mention in its description, not a test we ran.
- Is notion-mcp-server official and is it maintained?
- We found nothing naming it as a vendor’s official server. Its repository has 178 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-10-21.
- What licence does notion-mcp-server use?
- The repository declares the MIT licence.
More MCP servers for project & docs
- mcp-obsidian4,486 stars
- mcp-notion-server924 stars
- obsidian-mcp-server699 stars
- todoist-mcp562 stars
- linear-mcp-server347 stars
- notion_mcp208 stars