Skip to main content
Glama

MCP Server for Notion

License: AGPL v3 Node.js TypeScript Docker

This tool provides the Notion API as an MCP (Model Context Protocol) server. It enables AI agents to search, view, create, and update Notion pages, as well as operate on databases.

Features

Page & Database Operations

Supports major operations such as search, retrieval, creation, updates, and appending blocks.

File-based Operations

Drastically reduces LLM token usage by saving/loading page content (JSON) to/from files.

Response Extraction (extract)

Optimizes context size by extracting only the necessary properties from the API response.

Related MCP server: Notion MCP Server

Quick Start

Local Development Environment

  1. Install:

    git clone https://github.com/acckkiie/notion-mcp-server
    cd notion-mcp-server
    npm install
  2. Configure: Copy .env.example to create .env and set your Notion API key.

    cp .env.example .env
    # Edit .env: NOTION_API_KEY=secret_...
  3. Run:

    npm run dev

Image Build

npm run build
docker build -t notion-mcp-server:latest .

MCP Client Configuration

Using Docker reduces environment dependencies and enables security control via proxy.

{
  "mcpServers": {
    "notion-mcp-server": {
      "disabled": false,
      "command": "bash",
      "args": [
        "-c",
        "docker compose -f /path/to/notion-mcp-server/docker-compose.yml down 2>/dev/null; docker compose --env-file /path/to/notion-mcp-server/.env -f /path/to/notion-mcp-server/docker-compose.yml run --rm -i notion-mcp-server"
      ],
      "env": {
        "HOST_WORKSPACE_PATH": "/path/to/your/workspace"
      }
    }
  }
}

Local Execution

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "/path/to/notion-mcp-server/build/index.js"
      ],
      "env": {
        "NOTION_API_KEY": "secret_...",
        "HOST_WORKSPACE_PATH": "/path/to/your/workspace"
      }
    }
  }
}

License

GNU Affero General Public License v3.0 (AGPL-3.0)

Available Tools

13 tools
notion_append_block_childrenB

IMPORTANT: You MUST write the JSON payload (array of children) to a file first, then pass the file path in 'file_path'. Appends content blocks.

Inputs: block_id (required), file_path (required), extract.

notion_create_databaseA

IMPORTANT: You MUST write the JSON payload (including 'parent', 'title', 'properties') to a file first, then pass the file path in 'file_path'. Creates a database as a subpage in a specified parent.

Inputs: file_path (required), extract.

notion_create_pageA

IMPORTANT: You MUST write the JSON payload (including 'parent', 'properties', 'children') to a file first, then pass the file path in 'file_path'. Creates page in database or as subpage.

Inputs: file_path (required), extract.

notion_delete_blockA

Deletes a block (sets in_trash: true).

Inputs: block_id (required), extract.

notion_query_databaseA

Queries database with filters/sorts. Returns array of pages (results). Supports pagination

Inputs: database_id (required), sorts, filter, extract, +2 more.

notion_retrieve_blockB

Retrieves a block by ID.

Inputs: block_id (required), extract.

notion_retrieve_block_childrenA

Retrieves child blocks (paragraphs, headings, lists, etc.) of page or block. Supports pagination

Inputs: block_id (required), extract, page_size, start_cursor.

notion_retrieve_databaseA

Retrieves database schema: property definitions, title, description

Inputs: database_id (required), extract.

notion_retrieve_pageA

Retrieves page metadata: properties, parent, timestamps, archived status

Inputs: page_id (required), extract.

notion_update_blockC

IMPORTANT: You MUST write the JSON payload to a file first, then pass the file path in 'file_path'. Updates a block.

Inputs: block_id (required), file_path (required), extract.

notion_update_databaseA

IMPORTANT: You MUST write the JSON payload to a file first, then pass the file path in 'file_path'. Updates database title, description, or properties.

Inputs: file_path (required), database_id (required), extract.

notion_update_pageA

IMPORTANT: You MUST write the JSON payload to a file first, then pass the file path in 'file_path'. Updates page properties, archive status, icon, or cover.

Inputs: page_id (required), file_path (required), extract.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a distinct Notion resource and action: pages, databases, blocks, search, and query operations are clearly separated. Tools like notion_search and notion_query_database work differently enough that an agent should not confuse them.

    Naming Consistency5/5

    All tools follow a consistent notion_verb_noun pattern (e.g., notion_retrieve_page, notion_create_database, notion_update_block, notion_append_block_children). The verb and resource order is uniform across the entire tool set, making the naming predictable.

    Tool Count5/5

    Thirteen tools is well-scoped for Notion's content model, covering pages, databases, blocks, child-block operations, and search. Each tool covers a meaningful operation without excessive fragmentation or overlap.

    Completeness4/5

    The tool set provides strong coverage of Notion's core workflows: creating, retrieving, updating, querying, and searching pages, databases, and blocks. Minor gaps exist such as no explicit delete-database or page-deletion tool, though page archiving can be handled via update_page and block deletion is supported.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to interact with Notion workspaces through the Notion API. Supports reading, writing, commenting, and managing Notion pages and databases with optimized token consumption for AI agents.
      19
      282,573 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Integrates Notion with Claude Code, enabling search, read, and write operations on Notion pages and databases via the Model Context Protocol.
      5,456 npm
      MIT