Notion MCP Server

Search, query, and edit your Notion workspaces through an AI-integrated interface.

Data last scanned yesterday · Reviewed today

48 1 dangerous tool31 tools★ 920TypeScriptMIT

Overview

The Notion MCP Server provides a bridge between AI agents and the Notion API, enabling direct access to your workspace data. Users can search for content, perform schema-aware queries, and update pages using a variety of block types including paragraphs, headings, and todo lists. It also offers advanced tools for interacting with databases, comments, and user information. Designed for interactive workflows, the server includes optional MCP Apps such as a Data Source Explorer and Page Workbench. It targets the 2026-03-11 Notion API version and provides structured results for compact AI processing.

Our verdict

This server carries a high-risk score of 48/100, primarily because it is a community-maintained project rather than an official Notion release, and its OAuth and authentication mechanisms have not yet undergone independent review. While it is feature-rich, users should be cautious and only grant the integration specific access to the pages and databases they intend to manage, rather than full workspace permissions.

Supports a wide array of Notion block types for editing.
Compact response formatting optimized for AI agents.
Includes specialized tools like the Page Workbench and Data Source Explorer.
Low supply-chain risk with only five direct dependencies.

Security review for OAuth and authentication is currently missing.
Not an official, vendor-maintained integration.
Read-only mode and security controls remain unverified.

Setup

Claude Desktop

{
  "mcpServers": {
    "mcp-notion-server": {
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
notion_find	Search pages or data sources and return compact candidates with stable IDs and suggested next tools.	low
notion_read_page	Read page metadata plus child blocks as a compact outline, Markdown, or structured JSON.	low
notion_inspect_data_source	Summarize data source properties, option values, and relation targets.	low
notion_query_data_source_by_values	Query a data source with schema-aware simple filters and sorts.	low
notion_create_data_source_item_from_values	Create a data source item from simple values keyed by exact property name.	medium
notion_append_content	Append common Notion blocks without raw block JSON.	medium
notion_append_markdown	Append a safe subset of Markdown as Notion blocks.	medium
notion_update_content	Update one existing simple block.	medium
notion_update_content_batch	Validate and update multiple existing simple blocks.	medium
notion_open_data_source_app	Opens the interactive Data Source Explorer.	low

Compatibility

Client	Local	Docker	Remote	Read-only
Claude Desktop
Cursor
VS Code
Windsurf
ChatGPT

Frequently asked questions

›What Notion API version does this server support?

This server is designed to work with the Notion API version 2026-03-11.

›How do I grant the server access to my Notion workspace?

You must explicitly share specific pages or databases with your integration by using the Connections menu within Notion, as integrations cannot access workspace content by default.

›Which integration capabilities do I need to enable?

You must enable read, insert, and update content capabilities for standard operations, while comment or user information capabilities are only required if you intend to use those specific tools.

›Does this server support local development or custom builds?

Yes, you can run a local build by pointing the MCP host configuration command to the absolute path of your local build/index.js file and ensuring Node.js 22 or newer is installed.

›Are there optional interactive interfaces available?

Yes, the server provides optional MCP Apps, specifically the Data Source Explorer and Page Workbench, for more interactive Notion workflows.