Skip to main content
Glama
cloud9-labs

Notion MCP Server

by cloud9-labs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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: @node2flow/notion-mcp

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

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:

License

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • @node2flow/notion-mcp

    node2flow-th
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for the Notion API, enabling management of pages, blocks, databases, data sources, comments, and users through natural language.
    6
    2
    MIT

  • notion-mpm

    bobmatnyc
    F
    license
    A
    quality
    C
    maintenance
    Enables interaction with Notion workspaces through a comprehensive set of tools for managing pages, blocks, databases, users, comments, and search. Provides both a clean Python API and an MCP server for use with Claude Desktop.
    21
    -