| FMRS | 61 / 100 · C | 64 / 100 · C |
|---|
| Reliability | 9 / 20 | 10 / 20 |
|---|
| Security and permissions | 11 / 20 | 12 / 20 |
|---|
| Maintenance | 11 / 20 | 12 / 20 |
|---|
| Documentation | 17 / 20 | 16 / 20 |
|---|
| Setup experience | 13 / 20 | 14 / 20 |
|---|
| Best for | - Automation and CI scenarios that need headless token auth (Notion's hosted MCP is OAuth-only)
- Agents where context/token cost matters (only 422 tokens of tool schema at connection)
- Workflows needing batch mutations, idempotency, retries, and rate limiting
- Self-hosted deployments and developers exposing their own HTTP endpoint
- Users of any MCP-speaking client (Claude, Cursor, VS Code, Cline, Zed, Continue, etc.)
| - Individuals who want to talk to Claude from their personal WhatsApp number
- Developers comfortable configuring from a terminal and using the Claude Code development flag
- Automation scenarios needing remote tool approval from a phone
|
|---|
| Not for | - Users who want a one-click Notion connection inside claude.ai or ChatGPT web UIs (use Notion's hosted MCP; ChatGPT's built-in connectors require OAuth-hosted servers)
- Teams that prefer the official open-source server's one-tool-per-endpoint surface
- Organizations unwilling to grant a third-party open-source service their Notion token (unless they audit or self-host)
| - Compliance scenarios requiring the official WhatsApp Business API or a Meta developer account
- Teams needing officially hosted, multi-tenant, or cloud multi-instance deployment
- Environments unable to guarantee only one client instance at a time
- Users expecting voice transcription without setting up mlx-whisper themselves
|
|---|
| Required permissions | - Requires NOTION_TOKEN: a Notion Personal Access Token (ntn_…, recommended — scope equals your account, expires in ~1 year) or an Internal Integration secret (only pages explicitly Connected)
- Optional NOTION_PAGE_ID as default parent for create_page / create_database
- Optional NOTION_UPLOAD_ROOT to confine which local directory upload_file's path source can read
- Optional read-only deployment via NOTION_READ_ONLY=true or NOTION_ALLOWED_OPERATIONS=read; fine-grained control via NOTION_ALLOWED_OPERATIONS / NOTION_BLOCKED_OPERATIONS with group presets
| - Read and send WhatsApp messages as your personal number
- Access the local runtime state directory ~/.whatsapp-channel/ (auth, allowlists, group configs, inbox)
- Read and write local repository files and run scripts (e.g. bun scripts/access.ts, scripts/watchdog.sh)
- Optional local voice transcription (ffmpeg and an mlx-whisper environment)
|
|---|
| Risks and side effects | - The token acts as you: a PAT sees everything you can see, so a leak equals workspace exposure — issue per-member tokens and revoke immediately if a device is lost
- When binding a non-loopback HTTP host, anyone reaching /mcp acts as your NOTION_TOKEN; failing to set MCP_AUTH_TOKEN is a serious exposure
- Without NOTION_UPLOAD_ROOT, an upload_file path source can read any file the server process can access
- Many write ops can modify or remove content: blocking the destructive group does not disable parameter-based removals like update_database's in_trash — use READ_ONLY or allow=read for guaranteed no-mutation
- HTTP mode is single-tenant with one shared token — unsuitable for multi-user sharing
| - Messages Claude sends appear from your own number and are indistinguishable to recipients
- WhatsApp allows one linked-device session per account; running two servers makes them kick each other off
- Access-control commands are deliberately not MCP tools (terminal-only); exposing them to the message side risks prompt injection
- Session waking depends on the Claude Code channel extension; other clients get no push
- A known Claude Code client bug (#37933) may cause messages not to arrive, a client-side issue
- Launching with --dangerously-load-development-channels carries risk, so verify the source is trustworthy
|
|---|
| Supported clients | Claude Code, Claude Desktop, Cursor, VS Code, Cline, Zed, Continue, ChatGPT | Claude Code, Codex, Gemini CLI, Cursor |
|---|
| Tools | 2 | 10 |
|---|