suekou/mcp-notion-server

npx -y @suekou/mcp-notion-server (with NOTION_API_TOKEN env) — Claude Desktop, Cursor, and other MCP hosts
Local build: node /absolute/path/to/suekou-mcp-notion-server/build/index.js

Usage

• •Create an internal Notion integration, grant only needed capabilities (read/insert/update content, comments, user info), and share the pages/databases you want accessed
• •Recommended workflow: notion_find → notion_read_page → notion_inspect_data_source → notion_query_data_source_by_values / notion_create_data_source_item_from_values → append/edit tools → raw JSON tools only for advanced shapes
• •Restart the MCP host after saving the config

Key features

• ✓Search and target discovery with notion_find; compact page reading with stable block IDs via notion_read_page
• ✓Data source schema inspection and schema-aware querying/item creation with simple values
• ✓Simple page editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers, and safe Markdown append
• ✓Raw Notion API tools for advanced block, page, database, data source, comment, and user operations
• ✓Optional MCP Apps: Data Source Explorer and Page Workbench; structured tool results

Best for

Agents that need to read and edit pages in a Notion workspace with compact responses and schema-aware data source access.

Caveats

• ⚠Requires a Notion internal integration token; the integration only accesses pages/databases explicitly shared with it
• ⚠Targets the Notion API 2026-03-11 and the current database/data source model
• ⚠Development requires Node.js 22+ and pnpm