MCP.so
Sign In

Notion MCP Server

@ccabanillas

Repository

About Notion MCP Server

A Model Context Protocol (MCP) server implementation for Notion integration, providing a standardized interface for interacting with Notion's API.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@ccabanillas/notion-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Notion MCP Server?

Notion MCP Server is a Model Context Protocol (MCP) server implementation for Notion integration. It provides a standardized interface for interacting with Notion’s API and is compatible with Claude Desktop and other MCP clients.

How to use Notion MCP Server?

Install via Smithery (npx -y @smithery/cli install @ccabanillas/notion-mcp --client claude) or manually by cloning the repository, creating a virtual environment, installing dependencies (uv pip install -e . or pip install -e .), and setting a NOTION_API_KEY environment variable in a .env file. Run python -m notion_mcp to test. For Claude Desktop, configure claude_desktop_config.json with the full path to the Python executable and the -m notion_mcp argument.

Key features of Notion MCP Server

  • List and query Notion databases
  • Create and update pages
  • Search across the Notion workspace
  • Get database details and block children
  • Full async/await support with httpx
  • Type-safe models using Pydantic v2

Use cases of Notion MCP Server

  • Listing and querying Notion databases from an MCP client
  • Creating and updating pages in Notion programmatically
  • Searching across an entire Notion workspace
  • Retrieving database details and block children for structured data extraction
  • Integrating Notion with Claude Desktop for AI‑assisted workflows

FAQ from Notion MCP Server

What does Notion MCP Server do?

It acts as a bridge between MCP clients (like Claude Desktop) and Notion’s API, allowing you to perform database queries, page operations, and workspace searches using a standardized protocol.

How do I get a Notion API key?

Go to https://www.notion.so/my-integrations, create a new integration with appropriate read/write capabilities, and copy the token. Then add it as NOTION_API_KEY in a .env file in the project root.

What runtime and dependencies are required?

You need Python (with uv or standard venv), httpx, Pydantic v2, and MCP 1.6.0. The server uses asynchronous HTTP requests via httpx.

Why am I getting connection or permission errors?

Check that your Notion API key is correct and that you have internet access. Also ensure you have shared the target databases with your integration from the database’s “Share” menu.

How does Notion MCP Server communicate with clients?

The server uses the Model Context Protocol (MCP) over standard input/output (stdio), as shown by the command and args configuration in claude_desktop_config.json.

Frequently asked questions

What does Notion MCP Server do?

It acts as a bridge between MCP clients (like Claude Desktop) and Notion’s API, allowing you to perform database queries, page operations, and workspace searches using a standardized protocol.

How do I get a Notion API key?

Go to https://www.notion.so/my-integrations, create a new integration with appropriate read/write capabilities, and copy the token. Then add it as `NOTION_API_KEY` in a `.env` file in the project root.

What runtime and dependencies are required?

You need Python (with `uv` or standard `venv`), httpx, Pydantic v2, and MCP 1.6.0. The server uses asynchronous HTTP requests via httpx.

Why am I getting connection or permission errors?

Check that your Notion API key is correct and that you have internet access. Also ensure you have shared the target databases with your integration from the database’s “Share” menu.

How does Notion MCP Server communicate with clients?

The server uses the Model Context Protocol (MCP) over standard input/output (stdio), as shown by the `command` and `args` configuration in `claude_desktop_config.json`.

Comments

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

ccabanillas

More Memory & Knowledge MCP servers

Rust Docs MCP Server

Govcraft

🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.

286

Context Portal MCP (ConPort)

GreatScottyMac

Context Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.

763

Memlord

MyrikLD

Memlord is a remote MCP server available at https://app.memlord.com.

OpenLore

aakarim

Serve your docs to AI agents over SSH and MCP. Agents use ls, cat, grep, find, and pipes against a virtual filesystem backed by your documentation. Identity-scoped access, governed writing with human approval, and portab

66

Orcha

westonhancock

Orcha is a unified context layer for AI tools and agents. It stores and indexes and exposes organizational, team, or individual knowledge. Files, structured databases, and connected sources live in one workspace, and age