| FMRS | 63 / 100 · C | 66 / 100 · C | 64 / 100 · C |
|---|
| Reliability | 8 / 20 | 8 / 20 | 8 / 20 |
|---|
| Security and permissions | 12 / 20 | 15 / 20 | 17 / 20 |
|---|
| Maintenance | 15 / 20 | 15 / 20 | 10 / 20 |
|---|
| Documentation | 15 / 20 | 15 / 20 | 16 / 20 |
|---|
| Setup experience | 13 / 20 | 13 / 20 | 13 / 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
| - Developers, content creators, and project teams using Atlassian Cloud
- Teams that want Atlassian access inside ChatGPT, Claude, Cursor, or VS Code
- Users who need natural-language search, write, and cross-product workflows
| - 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 without an Atlassian Cloud site or relevant product permissions
- Deployments requiring a self-hosted MCP server
- Users unwilling to grant an AI client access to Atlassian data or actions
- Jira Service Management or Bitbucket Cloud workflows requiring OAuth authentication
| - 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
| - Jira and Confluence provide read, write, and search permission groups
- Jira Service Management provides read and write access through API tokens only
- Bitbucket Cloud provides read and write access through scoped API tokens only
- Compass is available through OAuth 2.1 only
- The first OAuth installer for a site must have access to the Atlassian apps requested by the MCP scopes
- Organization administrators can manage domain controls, API-token authentication, app access, and audit logs
| - 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
| - AI clients can perform Jira, Confluence, Jira Service Management, Bitbucket, and Compass actions on the user’s behalf
- Prompt injection, indirect prompt injection, and tool-poisoning attacks may cause data exfiltration or unintended changes
- Use least privilege, scoped tokens, and minimal project or workspace access
- Require human confirmation for high-impact or destructive actions and monitor audit logs
| - 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 clients | Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Smithery | OpenAI ChatGPT, Claude, Cursor, Visual Studio Code (GitHub Copilot), GitHub Copilot CLI, Google Gemini CLI, Amazon Quick Suite, Local MCP-compatible clients via mcp-remote | Claude Desktop, Cursor, Zed, GitHub Copilot CLI |
|---|
| Tools | 11 | 0 | 9 |
|---|