Notion MCP Server

Notion MCP Server

A Model Context Protocol (MCP) server that provides full access to the Notion API. Search, create, and manage databases, pages, blocks, and users directly from Claude, Cursor, or any MCP-compatible client.

Features

• Search - Full-text search across all pages and databases
• Database Management - Create databases, query with filters and sorts
• Page Management - Create, read, update, and archive pages
• Block Management - Read, append, and delete content blocks
• User Access - List workspace members and get user details
• Built-in Rate Limiting - Automatic throttling (3 req/s) with 429 retry

Available Tools (13)

| Tool | Description | |------|-------------| | notion_search | Search across all pages and databases | | notion_get_database | Get database schema and details | | notion_query_database | Query database with filters and sorting | | notion_create_database | Create a new database in a page | | notion_create_page | Create a new page in a database or page | | notion_get_page | Get page properties and metadata | | notion_update_page | Update page properties or archive | | notion_get_block | Get a block by ID | | notion_get_block_children | Get child blocks of a page or block | | notion_append_block_children | Append content blocks to a page | | notion_delete_block | Delete (archive) a block | | notion_list_users | List all workspace users | | notion_get_user | Get user details by ID |

Quick Start

npx @cloud9-labs/mcp-notion

Prerequisites

• Node.js >= 20.0.0
• Notion Internal Integration token from My Integrations

Setting Up Notion Integration

1. Go to notion.so/my-integrations
2. Click "New integration"
3. Give it a name and select a workspace
4. Copy the Internal Integration Token
5. Share target pages/databases with the integration

Installation

Via npx (Recommended)

No installation needed - configure your MCP client to use npx.

Via npm

npm i -g @cloud9-labs/mcp-notion

From Source

git clone https://github.com/cloud9-labs/mcp-notion.git
cd mcp-notion
npm ci
npm run build

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@cloud9-labs/mcp-notion"],
      "env": {
        "NOTION_API_KEY": "ntn_your_integration_token_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@cloud9-labs/mcp-notion"],
      "env": {
        "NOTION_API_KEY": "ntn_your_integration_token_here"
      }
    }
  }
}

Usage Examples

• "Search for all pages about marketing"
• "Query the Tasks database for items assigned to me"
• "Create a new page in database abc123 with title Meeting Notes"
• "Add a paragraph block to page xyz789"
• "List all users in the workspace"
• "Get the schema of database def456"

Building an AI Sales Automation System?

This MCP server is part of an open-source toolkit for AI-powered sales automation. We are building MCP servers that connect your entire sales stack.

Follow our progress and get updates:

• X (Twitter): @cloud9_ai_labs
• GitHub: cloud9-labs

License

MIT