Notion MCP Server

🚀 Notion MCP Server

A Model Context Protocol (MCP) server that offers the official Notion SDK, enabling AI models to interact with Notion workspaces.

🚀 Quick Start

1. Set up your Notion integration

1. Visit https://www.notion.so/my-integrations.
2. Create a new integration.
3. Copy the API key.

2. Connect your Notion pages to the integration

To allow your integration to access Notion content, you need to explicitly share pages or databases with it:

1. Navigate to the Notion page or database you want to access via the integration.
2. Click the "Share" button in the top - right corner.
3. In the "Add people, groups, or integrations" field, select your integration from the dropdown list.
4. Click "Invite".
5. Repeat the above steps to share each page or database.

⚠️ Important Note

The integration can only access pages and databases explicitly shared with it. Child pages automatically inherit the permissions of their parent pages.

3. Add it to your AI assistant

You can add this MCP server to Claude Desktop, Cursor AI, or Claude.ai using one of the following configuration formats:

Command - line format

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON configuration format

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

Replace your-notion-integration-key with the API key you copied in step 1.

Setup Guides

• Claude Desktop: Settings > Advanced > Model Context Protocol
• Cursor AI: Settings > AI > MCP Server
• Claude.ai (Web): Profile > Settings > API and Integrations > Model Context Protocol

✨ Features

The server provides tools for interacting with Notion:

• Search: Find pages or databases.
• Database: Query and retrieve database entries.
• Page: Create, get, and delete pages.
• Block: Manage block content within pages.
• Property: Manipulate page properties.

For detailed documentation on each tool, refer to Tool Documentation.

📚 Documentation

Configuration using environment variables

Create a file named .env and add the following content:

NOTION_API_KEY=your-notion-integration-key

Then run the following command in the project root directory to apply the settings:

source .env

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.