| FMRS | 57 / 100 · C | 64 / 100 · C |
|---|
| Reliability | 8 / 20 | 8 / 20 |
|---|
| Security and permissions | 8 / 20 | 17 / 20 |
|---|
| Maintenance | 13 / 20 | 10 / 20 |
|---|
| Documentation | 16 / 20 | 16 / 20 |
|---|
| Setup experience | 12 / 20 | 13 / 20 |
|---|
| Best for | - Developers blocked by OAuth app registration or admin approval
- Users across Claude Code, Cursor, Copilot, Windsurf, Gemini CLI, and Codex CLI
- Self-hosters who want tokens and data kept local
| - 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 | - Workspaces whose acceptable-use policy forbids unofficial clients (consider the OAuth hosted tier)
- Compliance-sensitive environments uncomfortable reusing personal browser session credentials
- Teams needing official Slack support (not affiliated with Slack Technologies)
| - 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 Slack browser session token (xoxc-) and cookie (xoxd-); the agent's footprint equals your browser session exactly
- On macOS, Chrome auto-extraction reads Chrome's local LevelDB and the Chrome Safe Storage key from the Keychain
- Write tools (send, react, mark read) carry MCP destructive annotations so clients can gate them
| - 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 | - Automating your own session is a gray area under Slack's terms — this is an unofficial client
- No app install appears in the admin panel, but traffic is still subject to workspace compliance exports, DLP, and retention
- Session tokens expire roughly every 1–2 weeks, requiring re-extraction or the hosted OAuth tier
- Tokens equate to your full Slack session; a leak means a session leak
| - 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, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI, Codex | Claude Desktop, Cursor, Zed, GitHub Copilot CLI |
|---|
| Tools | 21 | 9 |
|---|