{"id":"ccabanillas-notion-mcp","name":"notion-mcp","homepage":null,"repo_url":"https://github.com/ccabanillas/notion-mcp","category":"devtools","subcategories":[],"tags":["mcp","notion","python","agent-tools","integration","pydantic","httpx"],"what_it_does":"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.","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)"],"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.","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"],"af_score":62.5,"security_score":62.5,"reliability_score":32.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:45:20.766343+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Notion integration token via NOTION_API_KEY environment variable"],"oauth":false,"scopes":false,"notes":"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":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No hosted pricing is described; it appears to be open-source/self-hosted."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":62.5,"security_score":62.5,"reliability_score":32.5,"mcp_server_quality":70.0,"documentation_accuracy":65.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":90.0,"rate_limit_clarity":10.0,"tls_enforcement":80.0,"auth_strength":70.0,"scope_granularity":30.0,"dependency_hygiene":60.0,"secret_handling":70.0,"security_notes":"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.","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":50.0,"error_recovery":40.0,"idempotency_support":"false","idempotency_notes":"Not described in provided README. MCP write operations (create/update pages) may not be idempotent unless implemented explicitly.","pagination_style":"none","retry_guidance_documented":false,"known_agent_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)"]}}