Notion MCP Server

With Notion connected, an agent can read a spec page before writing code, then update the task's status or leave a comment when the work is done. There are two servers: Notion's hosted one at mcp.notion.com and the open-source @notionhq/notion-mcp-server package. Notion recommends the hosted server and says the local package is no longer actively maintained.

Setup

• Hosted: claude mcp add --transport http notion https://mcp.notion.com/mcp, then run /mcp in Claude Code and finish the OAuth flow. The agent reaches what your account can access.
• Local: npx -y @notionhq/notion-mcp-server with NOTION_TOKEN set to an internal integration secret (ntn_...). Only pages shared with the integration are visible, and an integration with only "Read content" is read-only.

What it exposes

• Hosted: notion-search, notion-fetch, notion-create-pages, notion-update-page, notion-query-data-sources, notion-create-comment
• Local: tools derived from the Notion API, including query-data-source, retrieve-page-markdown and update-page-markdown

Limits

• On the hosted server, notion-search is capped at 30 requests per minute on top of the standard API limits.
• Some search filters, and AI search across connected apps, depend on the workspace plan.
• The local server can't delete databases, but Notion still warns of a non-zero risk to workspace data.

Use the hosted server unless you need to run the process yourself with a fixed integration token.