notion-mcp

Provides an MCP (Model Context Protocol) server (Python) that integrates with Notion’s API to let MCP clients list/query databases, create/update pages, search a Notion workspace, and fetch database details and block children.

Evaluated Mar 30, 2026 (21d ago)

Repo ↗ DevTools mcp notion python agent-tools integration pydantic httpx

⚙ Agent Friendliness

/ 100

Can an agent use this?

🔒 Security

/ 100

Is it safe for agents?

⚡ Reliability

/ 100

Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality

Documentation

Error Messages

Auth Simplicity

Rate Limits

🔒 Security

TLS Enforcement

Auth Strength

Scope Granularity

Dep. Hygiene

Secret Handling

Uses a Notion integration token via environment variable (.env). README indicates 'proper error handling with detailed logging', but does not confirm whether logs avoid leaking tokens or whether tool-level authorization is enforced. Rate limits and safe retry guidance are not documented.

⚡ Reliability

Uptime/SLA

Version Stability

Breaking Changes

Error Recovery

Best When

You want a local or self-hosted MCP tool surface for Notion that an MCP client (e.g., Claude Desktop) can call, and you can manage Notion integration permissions and token security.

Avoid When

You need enterprise-grade reliability, documented rate-limit headers/handling, or a turnkey hosted service with published uptime/SLA.

Use Cases

• Building an MCP-enabled assistant that can read and write Notion content
• Querying and browsing Notion databases from an agent via MCP
• Automating Notion page creation/update workflows
• Searching across a Notion workspace through MCP tools

Not For

• Public, unauthenticated use (it requires a Notion integration token)
• Use as a general-purpose Notion REST API proxy service for untrusted clients without additional protections
• Providing strong operational/SLA guarantees (not evidenced in provided docs)

Interface

REST API

GraphQL

gRPC

MCP Server

Yes

SDK

Webhooks

Authentication

Methods: Notion integration token via NOTION_API_KEY environment variable

OAuth: No Scopes: No

Authentication appears to be a single Notion integration token provided via .env as NOTION_API_KEY. The README does not describe fine-grained scopes or per-tool permissioning within the MCP server.

Pricing

Free tier: No

Requires CC: No

No hosted pricing is described; it appears to be open-source/self-hosted.

Agent Metadata

Pagination

none

Idempotent

False

Retry Guidance

Not documented

Known Gotchas

⚠ Requires correct Notion integration token and that target databases are shared with the integration
⚠ Agent actions that create/update pages may not be idempotent; repeated tool calls could duplicate or modify content
⚠ Local MCP server startup path/command must be configured correctly for the MCP client (e.g., Claude Desktop)

Alternatives

Use the Notion API directly with your own MCP server (or agent integration) Other MCP servers/integrations for Notion (if available) Direct SDK-based Notion integration without MCP

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for notion-mcp.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

API endpoint ↗ Agent guide ↗ Report inaccuracy

Scores are editorial opinions as of 2026-03-30.