Notion MCP server
officialNotion runs its own hosted MCP server that agents connect to through OAuth. The agent can search, read and write in the workspace with the same permissions as the user.
What an agent can do
- → Search Notion and connected sources
- → Read pages and databases
- → Create and update pages
- → Create new databases
- → Upload files up to 20 MiB
The server writes to the workspace with the user's full permissions and can move pages to Trash, so write access should be reviewed. Sign-in without a browser needs an MCP token, which only workspace owners on Business or Enterprise can create.
About the Notion MCP server
Notion MCP is a server that Notion itself hosts and maintains. It lets an AI assistant such as Claude, ChatGPT or Cursor work directly in your workspace, so nobody has to copy text back and forth. The connection goes to a single address at Notion and works on every Notion plan. The older open-source server, which you ran yourself with an integration token, is no longer actively maintained and Notion describes it as a last resort.
In practice, teams use it to find the right page without remembering where it lives, summarise meeting notes, draft new pages and keep databases current. The assistant can create a tracker, change properties in a database, leave comments, suggest edits for review and upload files of up to 20 MiB. On Business and Enterprise with Notion AI, search can also reach connected sources such as Slack, Google Drive and GitHub.
The assistant acts with the full permissions of the signed-in user: it can reach everything that person can reach, and nothing more. Only workspace members can connect, and guests are refused. The server can write, move pages and send them to Trash, so write access deserves a review before a wide rollout. On Enterprise, admins can approve which AI apps may connect, see which members have connected them and disconnect them again.
Things to ask
- Find our latest page about pricing and summarise what we decided.
- Summarise last week's meeting notes and list who is doing what.
- Create a new page in the team wiki with a draft onboarding plan for new sales hires.
- Which entries in the Projects database have the status Delayed, and who owns them?
- Leave a comment on the launch plan asking whether the press release date still holds.
Tools the server exposes
- notion-search
- notion-connector-search
- notion-fetch
- notion-query-meeting-notes
- notion-create-pages
- notion-update-page
- notion-move-pages
- notion-duplicate-page
- notion-delete-pages
- notion-create-database
- notion-update-data-source
- notion-query-data-sources
- notion-create-view
- notion-create-comment
- notion-get-comments
- notion-create-suggested-edit
- notion-create-file-upload
- notion-get-users
- notion-get-teams
- notion-get-tool-access
Part of these packages
Notion is part of these Walma packages.
Questions about Notion MCP
Is Notion MCP free, and which plans does it need?+
Notion says Notion MCP works on every plan. Some parts need more: search across connected sources and unlimited SQL queries against databases require Business or Enterprise with Notion AI, and MCP tokens exist only on Business and Enterprise. Request limits are higher on those two plans.
What is the Notion MCP server URL?+
https://mcp.notion.com/mcp, over Streamable HTTP. The older SSE address https://mcp.notion.com/sse will be retired on 23 February 2027, according to Notion. Clients that can only start local servers can connect through the mcp-remote bridge to the same address.
How does sign-in work?+
Through OAuth. The client opens a window where you pick your workspace and approve access, with no keys to paste. For automated flows without a browser, workspace owners on Business or Enterprise can create an MCP token in the Developer portal, which the client sends as a bearer token.
Can it change and delete content in Notion?+
Yes. It creates and updates pages and databases, moves and duplicates pages, comments and uploads files. The notion-delete-pages tool moves pages to Trash. Everything happens with the signed-in user's permissions. An admin can limit which tools a workspace-owned connection may use.
Which AI assistants does Notion MCP work with?+
Notion names Claude (web and desktop), ChatGPT, Gemini and Cursor, and has connection guides for Codex, Claude Code, Cursor, VS Code with GitHub Copilot, Devin, Antigravity and others. Any app that supports MCP can connect. In OpenAI clients, the notion-search and notion-fetch tools appear as search and fetch.
Can an admin control which AI apps may connect?+
On Enterprise, yes. Admins can approve individual AI apps and block all others, see which members have connected each app, disconnect one app or every connection at once, and set up sign-in through an identity provider such as Okta. Up to 200 custom MCP clients can be approved per workspace.
How does it differ from the open-source notion-mcp-server?+
The hosted server is run by Notion, signs in through OAuth and receives new tools continuously. notion-mcp-server on GitHub signs in with an integration token and requires you to run it yourself. Notion says it is no longer actively maintained and should only be used as a last resort.
Missing a connection?
We build and review MCP servers for teams that need them, and run them behind the same policy and log as the rest of the gateway.