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

Related MCP server: mcp-notion_connect

Available Tools (13)

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