Notion developer docs MCP: what works in Claude, ChatGPT, Cursor, and Grok Bot
Search and read the Notion API developer documentation.
Registry name: (v)
Set it up
URL https://developers.notion.com/mcp. No sign-in. Paste the URL and it connects. Copy-paste setup: Claude | Claude Code | Cursor | VS Code | ChatGPT
Status grid
| App | Status | Date tested |
|---|---|---|
| Claude | Untested | Not yet tested |
| ChatGPT | Untested | Not yet tested |
| Cursor | Untested | Not yet tested |
| Grok Bot | Untested | Not yet tested |
| MCP Inspector (reference client) | Untested | Not yet tested |
| MCP TypeScript SDK (reference client) | Partial | Sat Oct 17 2026 |
Hands-on test results
| App | Task | Result | Time | Detail | Date tested |
|---|---|---|---|---|---|
| MCP TypeScript SDK (reference client) | connect (no auth) | Works | 654 ms | Connected without sign-in in 654 ms. | Oct 17, 2026, 12:33 PM CT |
| MCP TypeScript SDK (reference client) | list tools | Works | 262 ms | 3 tools: search_notion_docs, query_docs_filesystem_notion_docs, submit_feedback. | Oct 17, 2026, 12:33 PM CT |
| MCP TypeScript SDK (reference client) | search_notion_docs ("model context protocol") | Works | 678 ms | search_notion_docs: about 34 KB returned. "Title: Key references Link: https://developers.notion.com/guides/mcp/build-mcp-client#key-references Page: guides/mcp/build-mcp-client Conte" | Oct 17, 2026, 12:33 PM CT |
| MCP TypeScript SDK (reference client) | query_docs_filesystem_notion_docs | Works | 196 ms | query_docs_filesystem_notion_docs: 98 characters returned. "exit: 0 --- stdout --- cli compliance custom-blocks guides openapi page prompts reference workers " | Oct 17, 2026, 12:33 PM CT |
| MCP TypeScript SDK (reference client) | search with nonsense query | Partial | 412 ms | search_notion_docs: about 11 KB returned. "Title: Remove a group member Link: https://developers.notion.com/reference/admin/remove-permission-group-member Page: reference/admin/remove" | Oct 17, 2026, 12:33 PM CT |
| MCP TypeScript SDK (reference client) | error handling (missing required input) | Works | 129 ms | search_notion_docs: tool error, 86 characters returned. "Input validation error: Invalid arguments for tool search_notion_docs: query: Required" | Oct 17, 2026, 12:33 PM CT |
Oct 17, 2026, 12:33 PM CT, MCP TypeScript SDK (reference client): Scripted client using the official MCP TypeScript SDK against https://developers.notion.com/mcp (Streamable HTTP, protocol 2025-11-25). No sign-in needed. Server Notion Docs v1.0.0. Read-only tasks only, chosen from the server's own tool list. 5 of 6 tasks passed.
Automated handshake
No public remote endpoint to check (local or package-only server).
Gotchas
- MCP TypeScript SDK (reference client): A nonsense query returned about 11 KB of results instead of an empty result, so an agent cannot tell "nothing found" from a weak match.
FAQ
Does the Notion developer docs MCP server work?
In our hands-on test on Oct 17, 2026, 5 of 6 tasks passed. Main gotcha: A nonsense query returned about 11 KB of results instead of an empty result, so an agent cannot tell "nothing found" from a weak match.
What is the Notion developer docs MCP server URL?
https://developers.notion.com/mcp (Streamable HTTP).
Does the Notion developer docs MCP server need sign-in?
No sign-in. Paste the URL and it connects.
How do I add the Notion developer docs MCP server to Claude, Cursor, VS Code or ChatGPT?
Follow our copy-paste setup guides: https://connectorreport.com/c/notion-developer-docs/setup/claude https://connectorreport.com/c/notion-developer-docs/setup/claude-code https://connectorreport.com/c/notion-developer-docs/setup/cursor https://connectorreport.com/c/notion-developer-docs/setup/vscode https://connectorreport.com/c/notion-developer-docs/setup/chatgpt
Compare with other tested connectors | Connector Weather
Request a hands-on test of Notion developer docs
Get the badge
Maintain Notion developer docs or write about it? Show its live ConnectorReport status in your README or docs.
Markdown (README, docs)
[](https://connectorreport.com/c/notion-developer-docs?utm_source=badge&utm_medium=embed&utm_campaign=notion-developer-docs)
HTML
<a href="https://connectorreport.com/c/notion-developer-docs?utm_source=badge&utm_medium=embed&utm_campaign=notion-developer-docs"><img src="https://connectorreport.com/badge/notion-developer-docs.svg" alt="Notion developer docs MCP status on ConnectorReport"/></a>
The badge updates on its own after every retest. How badges work