← Back to directory
COMPARE UP TO 4 SERVERS

Compare MCP servers

Compare scores, permissions, risks, and fit in one decision-focused table.

DimensionBetter Notion MCP ServerMarkdown-first Notion for AI agents -- pages, databases, blocks, and comments in one callNotion MCP ServerOfficial Notion MCP server for querying, editing, and managing Notion pages and databases via AI agents.
FMRS63 / 100 · C64 / 100 · C
Reliability8 / 208 / 20
Security and permissions12 / 2017 / 20
Maintenance15 / 2010 / 20
Documentation15 / 2016 / 20
Setup experience13 / 2013 / 20
Best for
  • Heavy Notion users who want Markdown-based collaboration with AI agents
  • Developers integrating Notion workflows into Claude Code, Cursor, and similar clients
  • Automation scenarios needing the full Notion surface: uploads, comments, block-level edits
  • Teams and individuals who already manage docs/wikis in Notion and want AI clients (Claude Desktop, Cursor, etc.) to operate on that content directly
  • Developers who want to self-host a local MCP server rather than use a remote hosted option
  • Automation/agent workflows that need to query or update Notion database records programmatically
Not for
  • Users seeking a server officially supported by Notion (this is third-party open source)
  • Users unwilling to grant a Notion integration token or complete OAuth consent
  • Environments with Node.js < 24 and no Docker available
  • Users who want the standard-OAuth, zero-JSON-config install with active official support — Notion recommends its newer remote Notion MCP server for that
  • Users uncomfortable handing a Notion integration token to a locally-run LLM client
  • Use cases needing capabilities the integration deliberately excludes, such as deleting databases
  • Long-term production deployments that need guaranteed maintenance, given this repo may be sunset
Required permissions
  • Requires a Notion integration token (ntn_ prefix); it can only access pages explicitly shared with the integration
  • HTTP mode requires a Notion Public Integration OAuth client ID and secret
  • Token is passed via the NOTION_TOKEN environment variable and is a secret
  • A Notion internal integration token (NOTION_TOKEN or the Authorization value in OPENAPI_MCP_HEADERS), scoped by that integration's Capabilities (can be limited to read-only)
  • Access limited to the specific pages/databases explicitly connected to the integration, not the whole workspace
  • A separate bearer auth token when using the Streamable HTTP transport (--auth-token / AUTH_TOKEN)
  • Network access to the Notion API
Risks and side effects
  • Third-party project not maintained by Notion; review the code yourself
  • In stdio mode the token is stored AES-GCM encrypted in a local config file, but the integration token itself is broad in scope
  • In hosted HTTP mode tokens live only in process memory and are cleared on restart
  • Setting MCP_AUTH_DISABLE=1 on a shared/public deployment collapses all users into a single token bucket -- a serious risk
  • Earlier versions had instability around credential handling and daemon-bridge auto-spawn; use the latest release
  • If the integration is granted broad read/write capabilities and connected to many pages, that content is effectively exposed to the LLM, risking data leakage or unintended edits
  • Running with --unsafe-disable-auth removes bearer authentication on the HTTP transport, potentially making it reachable via DNS rebinding from pages a user visits — the README says to only use it on an isolated network
  • Multi-tenant token passthrough requires careful TLS/gateway configuration; misconfiguration risks leaking or misrouting Notion tokens between tenants
  • The README states this local server may be sunset in favor of the remote Notion MCP, and that issues/PRs here are not actively monitored, so long-term maintenance and security fixes are not guaranteed
  • Storing NOTION_TOKEN or OPENAPI_MCP_HEADERS directly in shared client config files risks leaking the secret
Supported clientsClaude Code, Cursor, Codex, Gemini CLI, WindsurfClaude Desktop, Cursor, Zed, GitHub Copilot CLI
Tools119