How to add Notion MCP Server to Claude Desktop

AI-friendly MCP server for the Notion API — find, read, query, and update Notion workspaces with compact, agent-ready responses. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 907★ · stdio · apikey

Claude Desktop config for Notion MCP Server

npx -y @suekou/mcp-notion-server

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Notion MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Notion MCP Server's tools appear under the 🔌 tools menu.

Before you start

A Notion account with an internal integration created at the Notion integrations dashboard
A Notion integration token (NOTION_API_TOKEN) with the needed capabilities
Pages or databases shared with the integration via Content access / Connections
Node.js 22 or newer (for local builds); npx for the default install

What Notion MCP Server can do in Claude Desktop

notion_find

Search Notion and discover the target page or data source to work with.

notion_read_page

Read a page compactly, returning page context and stable, editable block IDs.

notion_inspect_data_source

Inspect a data source's schema before querying or creating items.

notion_query_data_source_by_values

Schema-aware querying of a data source using simple values.

notion_create_data_source_item_from_values

Create a data source item from simple values.

notion_append_markdown

Safely append Markdown content to a page.

notion_append_content

Append content blocks (paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers) to a page.

notion_update_content

Update a page's content block.

Security

Requires a Notion internal integration token (NOTION_API_TOKEN). Notion only lets an integration access pages and databases explicitly shared with it, and a connection added to a page also grants access to that page's children. Grant only the integration capabilities (read/insert/update content, comments, user info) that you actually need.

Notion MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Notion MCP Server config there under the "mcpServers" key and restart the client.

Is Notion MCP Server safe to use with Claude Desktop?

How do I authenticate?

Create an internal Notion integration, copy its secret token, and set it as NOTION_API_TOKEN in your MCP host config. Notion only exposes pages and databases that have been explicitly shared with the integration.

Which Notion API version does it target?

It targets the Notion API 2026-03-11 and uses the current database/data source model.

Can I run a locally built checkout instead of npx?

Yes. Build the project with pnpm and point the config command to node with args ["/absolute/path/to/suekou-mcp-notion-server/build/index.js"], keeping NOTION_API_TOKEN in env.

View repo Full Notion MCP Server page