Notion MCP: What It Does, How to Use It, and Whether It's Worth It
Notion's hosted MCP server lets AI tools read and edit your workspace. How to set it up, what it costs and where it stops.

Notion MCP connects your Notion workspace to AI tools through the Model Context Protocol, so Claude or Cursor can find a spec, read a database or update a page without you copying it into a chat. Notion hosts the server, you sign in with OAuth, and the AI sees exactly what your Notion account can see.
Below: what it can do, what it costs, how to connect each client, and where it stops being useful.
What is Notion MCP?
Notion MCP is a remote MCP server built and hosted by Notion. The recommended endpoint is https://mcp.notion.com/mcp over Streamable HTTP, with https://mcp.notion.com/sse as a fallback for clients that don't support it (Notion Developers). MCP is the open standard Anthropic introduced in November 2024 for connecting AI tools to outside apps; how Notion's server compares with Slack's, Gmail's and the rest is in Best MCP Servers for Work.
One design choice shapes how it behaves. Instead of returning raw block JSON, the server hands the model pages as "Notion-flavored" Markdown. Notion engineer Kenneth Sinder wrote that the original open-source server mapped each API endpoint 1:1 to a tool and suffered from "high-context token consumption" on hierarchical block data, and that Markdown gives better content density per token (Notion, 2025).
What can you do with Notion MCP?
You can search, read and edit almost anything in your Notion workspace from an AI client. Notion's tool reference lists more than 60 tools in October 2026 (Notion Developers).
Read tools
notion-searchacross pages, databases and users, plusnotion-connector-searchfor connected sources like Slack, Google Drive and GitHubnotion-fetchto pull a page, database, data source or view by URL or IDnotion-query-data-sourcesto run SQL, read rows or run a saved view, and a multi-source version for up to 100 data sources- Comments, teamspaces, users, recent and favorite pages, backlinks, meeting notes and Notion Calendar events
Write tools
notion-create-pages,notion-update-page,notion-move-pagesandnotion-duplicate-pagenotion-create-database, data source updates and database views- Comments, discussions and reactions
- Moving up to 20 pages or databases to Trash and restoring them
- File uploads up to 20 MiB, calendar events and Custom Agent sessions
Typical prompts: "summarize the Q4 roadmap page," "add today's meeting notes under the project page," "find every task in the sprint database that's blocked."
Is Notion MCP free?
Yes, Notion MCP works on every Notion plan, but several tools are gated by plan. Workspace guests can't connect at all (Notion Developers).
- Business or Enterprise with Notion AI: connected-source search, unlimited SQL queries across data sources, multi-source queries and meeting-notes queries.
- Business or Enterprise: extra search filters (last edited by, last edited date), comment editing and reactions, and MCP tokens for headless access.
- Enterprise: admin controls that limit members to an approved list of AI apps (Notion Help Center).
Notion's request limits allow 180 requests per minute per connection on most plans and 600 on Business and Enterprise, plus a shared per-workspace budget, and MCP tools also have per-tool limits of their own (Notion Developers). The server retries once when the wait is 2 seconds or less and otherwise returns a rate_limited error.
How do you connect Notion MCP to Claude, ChatGPT, Cursor and Codex?
Each client takes the same URL and sends you through Notion's OAuth screen; only the place you paste it changes.
Claude and Claude Desktop
- In a chat, click +, hover over Connectors and select Manage connectors.
- Click Browse connectors and choose Notion.
- Click Connect and approve access in Notion (Claude Help Center).
Claude Code
claude mcp add --transport http notion https://mcp.notion.com/mcp
Then run /mcp in a session to finish the OAuth sign-in. Add --scope user to make it available in every project.
Cursor
- Create
.cursor/mcp.jsonin the project, or~/.cursor/mcp.jsonfor all projects:
{
"mcpServers": {
"notion": { "url": "https://mcp.notion.com/mcp" }
}
}
- Enable Notion under Customize in Cursor and complete the OAuth flow.
Codex
- Add the Notion URL as an MCP server in
~/.codex/config.toml. - Run
codex mcp login notionto sign in.
ChatGPT
Notion's help center names ChatGPT among supported apps. Add https://mcp.notion.com/mcp as a custom MCP server from ChatGPT's developer mode, which OpenAI documents for Plus, Pro, Business, Enterprise and Edu; the steps are in How Does ChatGPT Use MCP?
What happened to the open-source Notion MCP server?
Notion no longer actively maintains its open-source notion-mcp-server package and points everyone to the hosted server (Notion Developers). The old server ran locally, used an internal integration token, and only saw pages you had shared with that integration. That scoping was its main appeal, but it also wrapped the REST API one endpoint per tool, which is exactly the token-heavy design the hosted version replaced.
If you still run it, move to mcp.notion.com/mcp and expect the tool names to change.
Can a background agent use Notion MCP?
Yes, on Business and Enterprise plans. Workspace owners can create an MCP token in Notion's Developer portal, and the client sends it as a bearer token with no browser sign-in. Enterprise workspaces with SAML SSO can also use enterprise-managed authorization, which skips the consent screen. On other plans the server is OAuth-only, so a person has to approve the connection in a browser first.
Where does Notion MCP fall short?
Its limits come from how it reaches your data, not from bugs.
- Full permissions. MCP tools act with your full Notion permissions and can reach anything you can. On every plan below Enterprise there's no admin list of approved apps.
- Prompt injection. Pages and comments written by other people are untrusted input. A planted instruction in a shared page can steer an agent that also has write or delete tools. See Is MCP Safe?
- Context cost. Markdown is leaner than JSON, but a long nested page or a big database still pours thousands of tokens into the window, on top of the tool definitions (the MCP context tax).
- Not the whole API. There's no tool for webhooks, so event-driven integrations still go through Notion's REST API.
- Pull on demand. The AI only reads Notion when the conversation sends it there. If you don't point it at the right page, it won't go looking.
Is Notion MCP worth it?
Yes, if your work lives in Notion and you want an AI to act on specific documents: summarize this spec, update this database, pull these three pages into the session. It's official, hosted, free on every plan, and supported by the clients most people already use.
It's less useful when what you want is for the AI to already know who you are and what you're working on. Notion MCP gives the model a place to look; it doesn't hand it a picture of your situation before you ask. That's the difference between a connector and a context layer, covered in Connectors vs MCP vs a Context Layer.
Where does Unabyss fit next to Notion MCP?
Unabyss does the second job. Notion is one of its live integrations: it imports the Notion content you approve when you connect, turns it into personal context alongside Gmail, Slack, Linear and your other apps, keeps that context current, and serves it to Claude, ChatGPT, Cursor and other MCP clients from one connection. It doesn't create or edit Notion pages. In an August 2026 Unabyss benchmark against a baseline with the same tools connected, adding Unabyss cut cost by 36% and time by 38%, and raised the quality of accepted output from 7.7 to 8.9 out of 10 (What Structured AI Context Is Worth).
Many people run both: Notion MCP to work on a document, Unabyss so every AI tool starts knowing the project. See how it works.