Notion — how agent-ready is it?
A genuinely agent-friendly workspace: hosted official MCP and self-serve tokens — held back by an API that still trails the UI and modest rate limits.
API surface — 7/10
Pages, databases, blocks and comments covered; some UI features (certain block types, workspace admin) still API-invisible.
MCP / agent protocol — 8.5/10
Official hosted MCP server working across Claude, Cursor and ChatGPT — one of the smoothest agent onboardings.
Docs quality — 8/10
developers.notion.com is clear and example-rich.
Auth friction — 8/10
Self-serve internal integration tokens; per-page/database sharing model doubles as a natural permission scope.
Rate limits & pricing fairness — 7/10
~3 requests/second average — fine for assistants, throttles bulk agent work.
ToS stance on agents — 8/10
Integrations and automation are the point of the platform; no anti-agent posture.
Machine-readable output — 8/10
Clean JSON block model; no public content without auth (by design for a private workspace).
Stability — 7.5/10
API stable since 2022; the 2025 multi-source database model brought a real migration.
Sources
Point-in-time assessment — platforms change their API terms often (that volatility is itself scored under Stability).
- developers.notion.com — API documentation (accessed 2026-07-12)
- developers.notion.com/docs/mcp — Official Notion MCP (accessed 2026-07-12)
- github.com/modelcontextprotocol/servers — MCP servers directory — official vendor servers (accessed 2026-07-12)
- developers.notion.com/reference/request-limits — Rate limits (accessed 2026-07-12)