Notion MCP server

Connect Notion

claude mcp add --transport http notion https://mcp.notion.com/mcp

[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"

{"mcpServers": {"notion": {"url": "https://mcp.notion.com/mcp"}}}

{"servers": {"notion": {"type": "http", "url": "https://mcp.notion.com/mcp"}}}

Every client finishes with a Notion OAuth sign-in in the browser, where you choose the workspace. In Claude.ai, Claude Desktop and ChatGPT, Notion is added from the app's connector settings. A Notion plugin for Claude Code adds skills and slash commands on top of the server.

What the Notion MCP server does

The Notion MCP server is Notion's hosted server for connecting AI agents to a Notion workspace. After you sign in with OAuth, the agent can search your workspace, fetch pages and databases in a Markdown-based format that uses few tokens, and create, update, move and duplicate pages. It can also create databases, change data source properties, set up database views with filters and sorts, and upload files up to 20 MiB.

Notion's server respects each user's existing permissions, so the agent sees only what you can see, with no integration token or manual page sharing. On workspaces with Notion AI, an AI search tool also searches connected apps alongside Notion. Workspace owners can see and revoke MCP connections in Settings, Connections, and Enterprise admins can allow or block specific MCP clients.

Notion also published an open-source local server, makenotion/notion-mcp-server, that uses an integration token. Notion now says that repo is no longer actively maintained and recommends the hosted server for most users; the local one remains an option for automated workflows that cannot complete an interactive OAuth sign-in.

Tools it gives your agent

• notion-search
• notion-ai-search
• notion-fetch
• notion-create-pages
• notion-update-page
• notion-move-pages
• notion-duplicate-page
• notion-create-database
• notion-update-data-source
• notion-create-view
• notion-create-file-upload
• notion-get-tool-access

When to use Notion

• You want the agent to turn meeting notes or a spec in Notion into code tasks.
• You want to write documentation from your codebase straight into a Notion page.
• You keep a project tracker in a Notion database and want the agent to add and update rows.
• You want answers from your team wiki without copying pages into the chat.

When to pick something else

• Unattended automation: the hosted server needs an interactive OAuth sign-in, and Notion says non-interactive authorization is not supported yet.
• Broad write access without review: the agent can edit and move any page you can edit.

What Notion needs

• A Notion account; Notion AI for searching connected apps

What the Notion MCP server costs

No separate charge, and Notion lists the MCP tools on all plans; searching connected apps through AI search needs Notion AI. The older local server is free under MIT.

Current prices: developers.notion.com ↗. We do not list prices: vendors change them often, so check the publisher's own page.

Other MCP servers for notes, docs and team tools

• Atlassian: The Atlassian MCP server gives AI agents access to Jira, Confluence, Jira Service Management, Bitbucket, Compass and Loom on Atlassian Cloud: search, summarize, and create or update issues and pages.
• Linear: The Linear MCP server gives AI agents access to your Linear workspace through Linear's hosted endpoint: find, create and update issues, projects and comments, with a read-only URL when you only need lookups.
• Obsidian: The Obsidian MCP server gives AI agents access to your Obsidian vault through the Local REST API plugin: list and read notes, search across files, append or patch content and delete files.
• Slack: The Slack MCP server gives AI agents access to a Slack workspace through Slack's hosted endpoint: search messages and files, read channels and threads, send messages, and edit canvases and lists.