@node2flow/notion-mcp

MCP server for the Notion API — manage pages, blocks, databases, data sources, comments, and users.

Quick Start

Claude Desktop / Cursor / VS Code

Add to your MCP client config:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@node2flow/notion-mcp"],
      "env": {
        "NOTION_API_KEY": "ntn_your_integration_token"
      }
    }
  }
}

HTTP Mode (Streamable HTTP)

NOTION_API_KEY=ntn_xxx npx @node2flow/notion-mcp --http

MCP endpoint: http://localhost:3000/mcp

Cloudflare Worker

https://notion-mcp-community.node2flow.net/mcp?NOTION_API_KEY=ntn_xxx

Configuration

Variable	Required	Description
NOTION_API_KEY	Yes	Notion Internal Integration Token (starts with ntn_ or secret_)

Getting a Notion API Key

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

Tools (25)

Search (1)

Tool	Description
notion_search	Search pages and databases by title

Pages (5)

Tool	Description
notion_create_page	Create a new page
notion_get_page	Get page by ID
notion_update_page	Update page properties, icon, cover
notion_move_page	Move page to new parent
notion_get_page_property	Get a specific property value

Blocks (5)

Tool	Description
notion_get_block	Get a block by ID
notion_get_block_children	Read page/block content
notion_append_blocks	Add content blocks to page/block
notion_update_block	Update block content
notion_delete_block	Delete (archive) a block

Data Sources (5)

Tool	Description
notion_create_data_source	Create a data source table
notion_get_data_source	Get data source by ID
notion_update_data_source	Update data source schema
notion_query_data_source	Query pages with filters/sorts
notion_list_data_source_templates	List data source templates

Databases — Legacy (3)

Tool	Description
notion_get_database	Get database by ID
notion_query_database	Query database with filters/sorts
notion_create_database	Create inline database in page

Comments (3)

Tool	Description
notion_create_comment	Comment on page or reply to thread
notion_get_comments	List comments on page/block
notion_get_comment	Get single comment by ID

Users (3)

Tool	Description
notion_list_users	List all workspace users
notion_get_user	Get user by ID
notion_get_bot_user	Get bot integration info

License

MIT License - see LICENSE

Copyright (c) 2026 Node2Flow

Links

• npm Package
• Notion API Documentation
• MCP Protocol
• Node2Flow