Notion MCP Server

What is Notion MCP Server?

Notion MCP Server implements the Model Context Protocol to interface with Notion’s API, enabling AI models to read and write Notion documents and data. It is built with the official MCP Python SDK and is intended for use with MCP‑compatible LLM clients like Claude for Desktop.

How to use Notion MCP Server?

Clone the repository, create a virtual environment, and install dependencies with uv. Obtain a Notion API key from the Notion integrations page and set it as the NOTION_API_KEY environment variable. Run python -m notion_mcp.server (stdio) or use --transport sse for SSE. For Claude for Desktop, add a claude_desktop_config.json file pointing to the uv executable and the server directory.

Key features of Notion MCP Server

• Supports 14 tools for pages, databases, blocks, comments, and search.
• Two transport methods: stdio (default) and SSE.
• Configured via a single environment variable (NOTION_API_KEY).
• Requires Python 3.12+ and the uv package manager.
• Seamlessly integrates with Claude for Desktop through a JSON config file.

Use cases of Notion MCP Server

• Create, read, and update Notion pages via an AI assistant.
• Query and create Notion databases programmatically.
• Append, update, or delete blocks within a page.
• Search across a Notion workspace for objects.
• Add comments to Notion pages through natural language requests.

FAQ from Notion MCP Server

How do I get a Notion API key?

Go to https://www.notion.so/my-integrations, create a new integration, and copy the API key. Then share the relevant Notion pages/databases with the integration by adding it as a connection.

What transport methods are supported?

The server supports standard input/output (stdio) for local clients and Server‑Sent Events (SSE) for web‑based integrations. Use the --transport flag to choose between them.

What are the runtime requirements?

Python 3.12 or higher and the uv package manager are required. All dependencies are installed via uv pip install -e ".[dev]".

How do I integrate it with Claude for Desktop?

Create a claude_desktop_config.json file in the Claude configuration directory with the absolute path to uv, the server directory, and the NOTION_API_KEY environment variable. See the README for exact syntax and platform‑specific paths.

I see a “spawn uv ENOENT” error. How do I fix it?

Claude Desktop cannot find the uv executable. Locate the full path using which uv (macOS/Linux) or where uv (Windows) and use that absolute path in the command field of the configuration file.