Notion MCP: what works in Claude, ChatGPT, Cursor, and Grok Bot
Priority connector for hands-on testing. Not yet tested.
Registry name: (v)
Set it up
URL https://mcp.notion.com/mcp. OAuth. Your client opens a browser window to sign in. 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) | Works | Fri Oct 16 2026 |
| MCP TypeScript SDK (reference client) | Untested | Not yet tested |
Hands-on test results
| App | Task | Result | Time | Detail | Date tested |
|---|---|---|---|---|---|
| MCP Inspector (reference client) | connect (OAuth) | Works | 1381 ms | Connected via OAuth. | Oct 16, 2026, 1:19 PM CT |
| MCP Inspector (reference client) | list tools | Works | 65 tools listed. | Oct 16, 2026, 1:19 PM CT | |
| MCP Inspector (reference client) | search (notion-search) | Works | 497 ms | Search returned results. | Oct 16, 2026, 1:19 PM CT |
| MCP Inspector (reference client) | read (notion-fetch) | Works | 300 ms | Fetched a page. | Oct 16, 2026, 1:19 PM CT |
| MCP Inspector (reference client) | create in sandbox (notion-create-pages) | Works | 452 ms | Created a page in the test workspace. | Oct 16, 2026, 1:19 PM CT |
| MCP Inspector (reference client) | error handling (bad id) | Works | 356 ms | Returned a clean tool error: object_not_found (404). | Oct 16, 2026, 1:19 PM CT |
Oct 16, 2026, 1:19 PM CT, MCP Inspector (reference client): MCP Inspector v2.11.0, free-plan test workspace, https://mcp.notion.com/mcp (Streamable HTTP). All 6 tasks passed.
Automated handshake
Needs sign-in HTTP 401, 798 ms, checked Fri, 16 Oct 2026 17:07:08 GMT
Gotchas
- MCP Inspector (reference client): The consent Continue button stays disabled until you tick "I recognize and trust this URL" for the redirect URL.
- MCP Inspector (reference client): The Inspector shows schema portability warnings on search, fetch, create-pages, update-page, and the attachment tools.
- MCP Inspector (reference client): On the free plan, search is keyword-only. AI search and some filters need Business or Enterprise.
- MCP Inspector (reference client): create-pages takes a pages array, so form-based clients need JSON mode. Creating with no parent puts the page at the workspace top level.
Errors and fixes
FAQ
Does the Notion MCP server work?
In our hands-on test on Oct 16, 2026, 6 of 6 tasks passed. Main gotcha: The consent Continue button stays disabled until you tick "I recognize and trust this URL" for the redirect URL.
What is the Notion MCP server URL?
https://mcp.notion.com/mcp (Streamable HTTP).
Does the Notion MCP server need sign-in?
OAuth. Your client opens a browser window to sign in.
How do I add the Notion MCP server to Claude, Cursor, VS Code or ChatGPT?
Follow our copy-paste setup guides: https://connectorreport.com/c/notion/setup/claude https://connectorreport.com/c/notion/setup/claude-code https://connectorreport.com/c/notion/setup/cursor https://connectorreport.com/c/notion/setup/vscode https://connectorreport.com/c/notion/setup/chatgpt
What errors does the Notion MCP server give?
Notion MCP: the consent Continue button stays disabled.
Compare
Best MCP servers for team productivity
Compare with other tested connectors | Connector Weather
Request a hands-on test of Notion
Get the badge
Maintain Notion or write about it? Show its live ConnectorReport status in your README or docs.
Markdown (README, docs)
[](https://connectorreport.com/c/notion?utm_source=badge&utm_medium=embed&utm_campaign=notion)
HTML
<a href="https://connectorreport.com/c/notion?utm_source=badge&utm_medium=embed&utm_campaign=notion"><img src="https://connectorreport.com/badge/notion.svg" alt="Notion MCP status on ConnectorReport"/></a>
The badge updates on its own after every retest. How badges work