Notion MCP Server

What it does

Connects your AI assistant to Notion, giving it read and write access to your entire workspace through the official Notion SDK. Create and update pages, query databases, manage content blocks, list users, and post comments — all from Claude Desktop, Cursor, or Claude.ai.

Tools

• search — Find pages or databases by keyword across the workspace
• databases_query — Query a database with filters and sorts, returning matching entries
• databases_retrieve — Retrieve a specific database's schema and metadata
• pages_retrieve — Get the full content and properties of a page
• pages_create — Create a new page inside a database or as a child of another page
• pages_update — Update page properties (title, status, tags, etc.)
• blocks_retrieve — Retrieve child blocks of any page or block
• blocks_append — Append new content blocks (paragraphs, lists, headings) to a page
• users_list — List all workspace members
• comments_create — Post a comment on a page
• comments_list — List all comments on a page

Installation

First create a Notion integration at https://www.notion.so/my-integrations and copy the API key. Share the pages/databases you want the AI to access with that integration.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json or project .cursor/mcp.json):

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": ["@ramidecodes/mcp-server-notion@latest", "-y", "--api-key=YOUR_KEY"]
    }
  }
}

Supported hosts

Confirmed in README: Claude Desktop, Cursor, Claude.ai (web).