Stack Score

Editorial pickMCP server

Notion MCP

Notion pages + databases from Claude.

Try Notion MCP

Best for

Teams running on Notion who want Claude to read, write, and search the workspace as a native data layer.

At a glance

Pricing: free
Setup time: 15 minutes
Learning curve: medium
Last verified: 5/26/2026

What we love

✓Official Notion-maintained server, kept current with API
✓Database query support is full-featured, not just reads
✓Block-level writes let Claude format pages naturally

Where it falls short

−Notion's API rate limits apply — bulk operations are slow
−Some block types like synced blocks have limited API support
−OAuth setup is more involved than a personal token

Install & connect

Copy-paste ready

Install

shell

npx -y @notionhq/notion-mcp-server

Config — Claude Desktop

json

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

Config — Cursor

json

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

Config — Claude Code

shell

claude mcp add notion -- npx -y @notionhq/notion-mcp-server --env NOTION_TOKEN=ntn_your_integration_token

Config — VS Code

json

{
  "servers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_your_integration_token"
      }
    }
  }
}

Pricing

✓ Pricing verified Jun 21, 2026

1 tier

Open source

MIT license

✓Self-hosted
✓Free forever
✓Official Notion maintained

Why we picked it

When your knowledge base lives in Notion, this MCP keeps the AI assistant in the same context.
— MoreAI.tools editor

Overview

Official Notion MCP — search workspace, create/update pages, query databases. Lets Claude maintain your knowledge base.

Key features

●Read and write Notion pages, databases, and properties
●Query databases with filters, sorts, and pagination
●Append blocks to pages — text, lists, todos, embeds
●Search across a workspace by title and content
●Create and update database schemas
●Comment on pages and reply to existing threads

Exposed tools

The MCP-tool names this server exposes. Your agent can invoke any of these when this server is connected.

search
Workspace-wide search across pages and data sources.
query-data-source
Query a Notion data source (database) with filters and sorts. v2.0+ replacement for post-database-query.
retrieve-a-data-source
Get schema and metadata for a data source.
create-a-data-source
Create a new data source under a parent page.
update-a-data-source
Update a data source's properties.
retrieve-a-database
Get database metadata including the list of data source IDs.
retrieve-a-page
Fetch a page's metadata and properties.
create-a-page
Create a new page under a page or database parent.
update-page-properties
Update properties on an existing page.
move-page
Move a page to a different parent.
retrieve-block-children
List the blocks under a page or block.
append-block-children
Append blocks to a page or block.
update-a-block
Update a block's content in place.
delete-a-block
Delete a block.
create-a-comment
Comment on a page or thread.
list-all-users
List workspace users the integration can see.

Best use cases

Knowledge base Q&A

Let Claude search and read your team wiki to answer questions with citations to source pages.

Auto-populating databases

Wire Claude into Notion as a project log, CRM, or content tracker that updates itself.

Meeting notes to action items

Drop transcripts into Claude and have it create properly structured Notion pages and tasks.

Integrations

Claude Desktop

Claude Code

Cursor

Cline

Notion API

Similar tools

See all mcp →

GitHub MCP

GitHub repos, issues, PRs through Claude.

Supabase MCP

Supabase database + auth + storage from Claude.

Slack MCP

Slack channels + messages from Claude.

Compare side-by-side

Notion MCP vs GitHub MCP vs Supabase MCP

Pros, cons, pricing, role-fit — all on one page.

Open comparison

One AI Stack pick every week.

The tool we’d pay for this week, why we’d pay for it, and what we’d skip. No promo spam.