Notion

Read and write Notion content from your agent via the official Notion MCP server.

#50 by GitHub starsDocumentation Planning & architecture Business workstdio transportAPI keyFreeChecked 2026-11-01

What it connects

Implements the Notion API over MCP so agents can search, read, create and update pages and databases. Needs a Notion integration token with access to the target pages.

Capabilities

Search Notion workspaces
Create and update pages and database entries

Compatibility

Compatibility by agent
Agent	Status
Claude Code	Reported (not hands-on tested)
Claude Desktop	Reported (not hands-on tested)

Clients listed by publisher: Claude Code, Claude Desktop, Cursor

Configuration

Claude Code

claude mcp add notion -- npx -y @notionhq/notion-mcp-server

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": {
          "Authorization": "Bearer ntn_YOUR_TOKEN",
          "Notion-Version": "2022-06-28"
        }
      }
    }
  }
}

Requirements

Notion integration token (starts with ntn_)
Pages shared with that integration

Source: https://github.com/makenotion/notion-mcp-server · Publisher: Notion · ★ 4.7k on the source repo

Setup instructions and compatibility are compiled from publisher docs and community reports, not hands-on testing, unless a step is marked Tested. Check the source before relying on a setup.