Notion MCP Server

A Model Context Protocol (MCP) server for interacting with Notion workspaces. Built with Python and FastMCP.

Features

• Search: Global search across pages and databases

• Databases: Query, create entries, get schema

• Pages: Create, read, update, archive pages

• Blocks: Read and append content blocks

• Users: List workspace users

Related MCP server: Notion MCP Server

Installation

pip install -r requirements.txt

Configuration

1. Create a Notion integration at developers.notion.com

2. Copy your API key

3. Set the environment variable:

export NOTION_API_KEY=secret_xxxxx

Or create a .env file:

NOTION_API_KEY=secret_xxxxx

4. Share pages/databases with your integration in Notion (Settings > Connections)

Usage

As MCP Server

python server.py

Claude Desktop Configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "notion": {
      "command": "python",
      "args": ["/path/to/notion-mcp/server.py"],
      "env": {
        "NOTION_API_KEY": "secret_xxxxx"
      }
    }
  }
}

Available Tools

Examples

Query a Database

# Using the MCP tool
notion_query_database(
    database_id="abc123...",
    filter_json='{"property": "Status", "status": {"equals": "Done"}}',
    limit=10
)

Create a Page

notion_create_page(
    parent_id="abc123...",
    title="My New Page",
    parent_type="page_id"
)

Append Content

notion_append_text(
    page_id="abc123...",
    text="Hello World!",
    block_type="paragraph"
)

License

MIT