Notion — can an agent use it?
One of the smoothest agent onboardings: official hosted MCP at mcp.notion.com plus a date-versioned REST API, both free on every plan. Ceilings are ~3 requests/second per connection, OAuth-only MCP that needs a human present, and no billing API at all.
Can an agent get correct information?
Machine-readable surface — 7.5/10
robots.txt allows general crawling, references 14 XML sitemaps and blocks no AI crawler (no GPTBot/ClaudeBot rules), and both www.notion.com/llms.txt and developers.notion.com/llms.txt exist alongside two published OpenAPI spec files — but the product itself is a JS-rendered private workspace with no public content surface and no Content Signals directives. source
Information retrieval quality — 7.5/10
Seat prices are published to the dollar ($0 Free / $10 Plus / $20 Business per member per month, AI at $10 per 1,000 monthly credits) and the changelog is current to 17/07/2026, but Enterprise is 'Custom pricing — Contact Sales' and the workspace-level rate limit added 16/06/2026 is described only as 'scaled to the workspace's plan' with no numbers published. source
Documentation for machines — 8.5/10
developers.notion.com carries a date-versioned API (2025-09-03, 2026-03-11) with per-version upgrade guides, a full error taxonomy of 16 codes across 11 HTTP statuses, two OpenAPI specs, an llms.txt index and a changelog updated eight days before assessment. source
Can an agent do the job?
Action coverage — 7.5/10
REST endpoints cover pages, blocks, databases, data sources, views, comments, users, search, file uploads and 20+ webhook events, but sharing/permission changes, member provisioning, template gallery and all billing actions remain UI-only, and audit logs are Enterprise-gated. source
Agent protocol support — 9/10
Notion hosts and actively ships an official MCP server at mcp.notion.com/mcp (legacy SSE at /sse) with ~20 purpose-built tools, one-click OAuth install in Claude, ChatGPT, Cursor, VS Code, Codex and Windsurf, and July 2026 changelog entries extending token life to ~8 hours and adding a current_tool_access capability map. source
Access & auth friction — 8/10
Personal access tokens are self-serve in minutes and the per-page/per-database connection model doubles as a permission scope, but PAT creation is 'restricted by default' on Business and Enterprise plans until a workspace owner enables it, and the hosted MCP 'requires user-based OAuth authentication and does not support bearer token authentication'. source
Agent payment capability — 2/10
Notion charges real money for seats and AI credits yet exposes no billing, subscription or seat endpoint anywhere in the API reference and supports none of ACP, AP2, MPP or x402 — every upgrade and seat purchase goes through a human clicking hosted checkout in Settings & billing. source
Cost & rate fairness — 6.5/10
The API costs nothing extra on any plan including Free with no per-call charge and no agent-vs-human price discrimination, but 'an average of three requests per second' per connection caps bulk agent work, a second workspace-level cap landed 16/06/2026 with unpublished numbers, and some MCP tools return an upgrade prompt rather than data on lower plans. source
Will it still work next quarter?
Permission & ToS stance — 8/10
Automation is the marketed product — Notion ships its own MCP server and integrations directory, robots.txt blocks SEO crawlers (AhrefsBot, SemrushBot, Amazonbot) but no AI agent, and there is no litigation or enforcement history against agents; the MSA only bars using the API 'to circumvent Subscription Fees' or to build a competing product, and the Developer Terms are hard to locate and last visibly dated 2022. source
Reliability & continuity — 7.5/10
status.notion.so runs a public status page with a dedicated API component and email subscriptions, older API versions keep receiving updates and the JS SDK ships @deprecated aliases for renamed fields, but two breaking version bumps in 18 months (2025-09-03 data sources, 2026-03-11 position/in_trash/meeting_notes renames) forced real migrations and no SLA is published below Enterprise. source
Sources
Point-in-time assessment — services change terms, prices and APIs often. That volatility is itself scored under Reliability & continuity. Re-verified at least quarterly.
- developers.notion.com/guides/mcp/get-started-with-m… — Official docs: hosted MCP endpoint mcp.notion.com/mcp plus /sse legacy transport; states MCP requires user-based OAuth and does not support bearer tokens, and 'may not be suitable for fully automated workflows or cloud-based coding agents that run without human interaction' (accessed 2026-07-25)
- developers.notion.com/page/changelog — Official changelog — entries dated 17/07/2026 (current_tool_access plan-gating map on notion-fetch), 15/07/2026 (app.notion.com link migration, email_verified), 14/07/2026 (MCP token lifetime 1h to ~8h), 16/06/2026 (new workspace-level rate limit scaled to plan) (accessed 2026-07-25)
- developers.notion.com/reference/request-limits — Official rate limits: average 3 requests/second per connection with bursts; workspace-level limit 'scaled to the workspace's plan' with no numbers; 429 rate_limited, 529 service_overload; 1,000 block and 500KB payload caps, 2,000-char rich text (accessed 2026-07-25)
- developers.notion.com/reference/status-codes — Official error taxonomy — 16 named error codes across HTTP 200/400/401/403/404/409/429/500/502/503/504 (accessed 2026-07-25)
- developers.notion.com/reference/intro — Official API reference index — objects and endpoint groups (blocks, pages, databases, data sources, views, comments, files, users, search, custom emoji, webhooks); no billing or subscription endpoint exists (accessed 2026-07-25)
- developers.notion.com/guides/get-started/upgrade-gu… — Official upgrade guide for API version 2026-03-11: after to position, archived to in_trash, transcription to meeting_notes; older versions still receive updates and JS SDK 5.12.0+ keeps deprecated aliases (accessed 2026-07-25)
- developers.notion.com/docs/create-a-notion-integrat… — Official quickstart — PATs are self-serve, but 'On Business and Enterprise plans, PAT creation is restricted by default. Ask a workspace owner to enable it in Settings & members → Connections' (accessed 2026-07-25)
- notion.com/pricing — Official pricing — Free $0, Plus $10/member/month, Business $20/member/month, Enterprise custom pricing via Contact Sales; Custom Agents $10 per 1,000 monthly Notion credits (accessed 2026-07-25)
- notion.com/blog/notions-hosted-mcp-server-an-inside… — Notion engineering post on the hosted MCP: OAuth install, Notion-flavored Markdown, purpose-built AI-first tools (create-pages, update-page, search, create-comment) rather than a 1:1 REST mapping, HTTP streaming and SSE transports (accessed 2026-07-25)
- d7umqicpi7263.cloudfront.net/eula/3QkIRed56NURE2biK… — Notion Master Subscription Agreement v.4 — API use governed by Developer Terms (s1.8); prohibits using the API 'to circumvent Subscription Fees', competitive-product use and reverse engineering (s2.1); no anti-bot or anti-scraping clause (accessed 2026-07-25)
- notion.com/robots.txt — robots.txt allows general crawling, lists 14 XML sitemaps, blocks BLEXBot/AhrefsBot/Amazonbot/SemrushBot/dotbot entirely, contains no GPTBot/ClaudeBot rules and no Content Signals directives (accessed 2026-07-25)
- github.com/makenotion/notion-mcp-server — Official open-source local MCP server, v2.1.0 released 31/01/2026, ~4.4k stars, supports NOTION_TOKEN bearer auth; repo states Notion is 'only providing active support for Notion MCP (remote)' and issues are not actively monitored (accessed 2026-07-25)
- stackone.com/blog/notion-mcp-deep-dive — Third-party audit of the hosted MCP: ~18 tools, OAuth-only, no block-level get/update/delete/append, no file uploads, and plan gating (data-source query reported as Enterprise + Notion AI, database-view query as Business + Notion AI) (accessed 2026-07-25)
- scalekit.com/blog/notion-mcp-vs-api — Third-party comparison: hosted MCP reported at 180 requests/minute per user with search capped at 30/minute and unsuitable for headless agents; REST API with integration tokens is the background-automation path (accessed 2026-07-25)
- apistatuscheck.com/blog/notion-status-guide — Third-party: confirms status.notion.so as the official status page with a dedicated API component covering integrations and developer-built apps, email subscriptions, 1-3 reported incidents per month, full outages rare (accessed 2026-07-25)