Notion MCP
Published · Updated
Notion's official remote MCP server. Read and write Notion workspaces directly from Claude Code — no self-hosting required.
claude mcp add --transport http notion https://mcp.notion.com/mcp Official Notion remote MCP server — hosted by Notion
What it does
Notion hosts an official remote MCP server at https://mcp.notion.com/mcp. Connecting Claude Code to it gives the agent read/write access to your Notion workspace — pages, databases, blocks, comments — authenticated through Notion’s OAuth flow.
How to connect
1. Claude Code CLI
claude mcp add --transport http notion https://mcp.notion.com/mcpAfter adding, run /mcp inside Claude Code to get the OAuth link. Sign in with Notion in the browser to finish the connection.
2. Connect from Notion settings
You can also connect directly from Notion → Settings → Integrations → Notion MCP.
Scope options
| Option | Description |
|---|---|
--scope local (default) | Available only in the current project |
--scope project | Shared across the team via .mcp.json |
--scope user | Available across all your projects |
Features
- Search pages — full-workspace content search
- Write documents — auto-generate PRDs, technical specs, release notes
- Database queries — inspect and update project status
- Edit content — markdown-based page updates
Use cases
- Search planning docs to confirm requirements, then update the Notion task state automatically after implementation.
- Generate release notes in Notion from code changes.
- Query a Notion project database for an at-a-glance status of ongoing work.
Why remote MCP
No local server to run, no token to rotate yourself — Notion handles hosting and auth. Ideal when you want the integration to “just work” without ops overhead.
Notes
- Image and file upload aren’t supported yet.
- OAuth is required, so fully headless/automated environments aren’t supported.
- Use
/contextto check current token usage. - Also available via the Claude Code plugin marketplace, which ships with bundled skills and slash commands.
Frequently Asked Questions
What is Notion MCP?
Notion's official remote MCP server. From Claude Code you can search, read, and write pages and databases in your Notion workspace.
Where does it run?
Claude Code and Claude Desktop.
How do I connect it?
Run `claude mcp add --transport http notion https://mcp.notion.com/mcp`, then `/mcp` to get the OAuth link and sign in with Notion. You can also connect from **Notion → Settings → Integrations → Notion MCP**.
How do I share it with my team?
Use `--scope project` to share via `.mcp.json` across the team. `--scope user` enables it across all your projects; the default `--scope local` keeps it project-local.
What can it do?
Full-workspace page search, auto-generation of PRDs, technical specs, and release notes, database queries and updates, and markdown-based page editing.
Are there limitations?
Image and file uploads aren't supported yet, and OAuth authentication means fully headless/automated environments aren't supported.