Official Productivity & Notes

Notion

Read, search, and write to your Notion workspace, pages, and databases.

Works with: Claude DesktopClaude CodeCursorWindsurfCline
Quick install
npx -y @notionhq/notion-mcp-server

How to install the Notion MCP server

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Add this to your Claude Code MCP configuration:

npx -y @notionhq/notion-mcp-server

Add this to your Cursor MCP configuration:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Add this to your Windsurf MCP configuration:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Add this to your Cline MCP configuration:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

The Notion MCP server is the most popular non-Anthropic MCP installation in the ecosystem. It gives Claude full access to your Notion workspace: read pages, query databases, create rows, update content, search across the workspace.

For teams or solo founders running their work in Notion, this is one of the highest-impact installs. Search inside Notion is fine but limited. Claude with the MCP server can synthesise across pages and databases in a way the native UI can’t.

Why use it

Notion is where most knowledge work lives. The friction is getting useful content into Notion without spending half your day copy-pasting from other tools. The MCP server removes that friction. Anything Claude has access to (your code, your bookmarks, your meetings) can land in a Notion database with one prompt.

Practical reality for marketers, product managers, and researchers: the Notion MCP server is what turns Notion from a passive place to write things down into an active hub that pulls from everywhere else you work.

What it actually does

A wide surface: search pages, read page content, query databases, create database rows, update properties, create new pages, comment, fetch user info. Claude composes these into bigger workflows automatically.

Practical patterns:

  • “Find all my Notion pages tagged ‘roadmap’ and summarize them.”
  • “Add today’s meeting notes to my ‘Weekly Check-ins’ database with status: in progress.”
  • “Search my workspace for anything mentioning the new pricing tier.”

Gotchas

Integration tokens are scoped manually. You have to share each page or database with the integration explicitly. This is a Notion design choice, not a server limitation. Default to least-privilege; share more only as needed.

Database schemas drift. If you add or remove properties, the server picks them up automatically but Claude’s mental model can lag. If queries start returning weird results, refresh the integration permissions.

For bookmark workflows, pair the Notion server with ContextBolt. One captures bookmarks across X, Reddit, and LinkedIn; the other promotes them into structured Notion databases on demand.

Example prompts for the Notion MCP server

Find all my Notion pages tagged 'roadmap' and summarize them.

Add today's meeting notes to my 'Weekly Check-ins' database.

Search my workspace for anything mentioning the new pricing tier.

MCP servers related to Notion

All in Productivity & Notes →

Linear

Manage Linear issues, projects, and cycles from your AI client.

Google Drive

Search and read files from Google Drive.

Obsidian

Query and edit your Obsidian vault from any MCP client.

Zapier

Trigger any of 5,000+ Zapier-connected apps from your AI client.

Notion MCP server: FAQs

Is the Notion server official?

Yes. Notion ships an official MCP server at @notionhq/notion-mcp-server. There are also several community alternatives with varying feature parity.

What permissions does it need?

A Notion integration token, scoped to whichever pages or databases you explicitly share with the integration. Don't share your entire workspace; start narrow and expand.

Can it create database rows?

Yes. Given write access to a database, the server can create, update, and read rows. This is the killer feature for promoting bookmarks, notes, or research into structured Notion tables.

Does it support comments and discussions?

Read-only for comments in the official server. Some community servers add write support but the API is more limited than for pages.

Can I use it alongside Obsidian?

Yes. Many users run both. ContextBolt + Notion + Obsidian in the same Claude Desktop session is a common power-user setup. Each plays a different role: ContextBolt for bookmarks, Notion for project work, Obsidian for personal notes.

Back to all MCP servers