How Notion’s scores are calculated

Point an agent at llms.txt or agent-oriented docsweight 2

2 (weight) × 9 (quality) × 1.0 (full) = 18.0 of 20 max

• [probe] https://developers.notion.com/llms.txt“PROBE llms.txt: HTTP 200 at https://developers.notion.com/llms.txt # Notion Docs - [Overview](https://developers.notion.com/guides/get-started/overview.md): Discover what Notion connecti”
• [probe] https://developers.notion.com/openapi.json“PROBE openapi: HTTP 200 at https://developers.notion.com/openapi.json — contains "openapi" key”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Notion MCP lets an MCP client, such as Claude Code, Cursor, or Codex, connect to your Notion workspace through the Model Context Protocol (MCP).”
• [claimed-docs] https://developers.notion.com/guides/mcp/hosting-open-source-mcp.md“If you need to run your own MCP server, the notion-mcp-server package is available as an open-source implementation.”

Run the product headlessly / in CI for automationweight 2

2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max

• [claimed-docs] https://developers.notion.com“Personal access tokens (PATs) are user-scoped tokens for scripts, CLI workflows, Workers, and tools that should act as one Notion user.”
• [claimed-docs] https://developers.notion.com“Internal connections are scoped to a single workspace and use a static API token. They're ideal for custom automations and workflows”
• [claimed-docs] https://developers.notion.com“With the REST API, you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more.”
• [probe] https://developers.notion.com/openapi.json“PROBE openapi: HTTP 200 at https://developers.notion.com/openapi.json — contains "openapi" key”
• [claimed-docs] https://developers.notion.com“create a personal access token, make your first API request, and see a new page appear in your workspace in under two minutes”

Plug MCP servers into this product so it can use their toolsweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

• [claimed-docs] https://developers.notion.com/guides/mcp/build-mcp-client.md“Build an MCP client that connects to Notion MCP using OAuth 2.0 with PKCE.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Notion MCP lets an MCP client, such as Claude Code, Cursor, or Codex, connect to your Notion workspace through the Model Context Protocol (MCP).”
• [claimed-docs] https://developers.notion.com/guides/mcp/hosting-open-source-mcp.md“If you need to run your own MCP server, the notion-mcp-server package is available as an open-source implementation.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Workspace owners can manage MCP client access in Settings → Connections.”

Connect an agent via an official MCP serverweight 3

3 (weight) × 8 (quality) × 1.0 (full) = 24.0 of 30 max

• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Notion MCP lets an MCP client, such as Claude Code, Cursor, or Codex, connect to your Notion workspace through the Model Context Protocol (MCP).”
• [claimed-docs] https://developers.notion.com/guides/mcp/build-mcp-client.md“Build an MCP client that connects to Notion MCP using OAuth 2.0 with PKCE.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Search content in Notion and connected sources. * Read, create, and update Notion content. * Create pages and databases.”
• [claimed-docs] https://developers.notion.com/guides/mcp/mcp-security-best-practices.md“Enable confirmation before actions that change content. This lets you review an action before the MCP client runs it.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Workspace owners can manage MCP client access in Settings → Connections.”
• [probe] https://developers.notion.com/docs/mcp“official MCP server documented at https://developers.notion.com/docs/mcp”

Use an official CLIweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

• [claimed-docs] https://developers.notion.com“Personal access tokens (PATs) are user-scoped tokens for scripts, CLI workflows, Workers, and tools that should act as one Notion user.”
• [claimed-docs] https://developers.notion.com“create a personal access token, make your first API request, and see a new page appear in your workspace in under two minutes”

Drive the product through a documented public APIweight 3

3 (weight) × 9 (quality) × 1.0 (full) = 27.0 of 30 max

• [claimed-docs] https://developers.notion.com“With the REST API, you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more.”
• [claimed-docs] https://developers.notion.com“Personal access tokens (PATs) are user-scoped tokens for scripts, CLI workflows, Workers, and tools that should act as one Notion user.”
• [claimed-docs] https://developers.notion.com“Public connections use OAuth 2.0 for authentication... Public connections must undergo a Notion security review before being listed on the Marketplace.”
• [claimed-docs] https://developers.notion.com“create a personal access token, make your first API request, and see a new page appear in your workspace in under two minutes”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Search content in Notion and connected sources. * Read, create, and update Notion content. * Create pages and databases.”
• [probe] https://developers.notion.com/llms.txt“PROBE llms.txt: HTTP 200 at https://developers.notion.com/llms.txt # Notion Docs - [Overview](https://developers.notion.com/guides/get-started/overview.md): Discover what Notion connecti”
• [probe] https://developers.notion.com/openapi.json“PROBE openapi: HTTP 200 at https://developers.notion.com/openapi.json — contains "openapi" key”
• [probe] https://developers.notion.com/docs/mcp“official MCP server documented at https://developers.notion.com/docs/mcp”

Issue scoped/least-privilege API credentials for an agentweight 2

2 (weight) × 7 (quality) × 0.6 (partial) = 8.4 of 20 max

• [claimed-docs] https://developers.notion.com“Internal connections are scoped to a single workspace and use a static API token. They're ideal for custom automations and workflows”
• [claimed-docs] https://developers.notion.com“Public connections use OAuth 2.0 for authentication. At creation time, you choose their installation scope”
• [claimed-docs] https://developers.notion.com“Internal connections are scoped to a single workspace and use a static API token.”
• [claimed-docs] https://developers.notion.com/guides/mcp/mcp-security-best-practices.md“Enable confirmation before actions that change content. This lets you review an action before the MCP client runs it.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/quickstart.md“The connection can access only Custom Agents that are explicitly shared with it.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Workspace owners can manage MCP client access in Settings → Connections.”

Build against official SDKsweight 2

2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max

• [claimed-docs] https://developers.notion.com“With the REST API, you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more.”
• [claimed-docs] https://developers.notion.com“Personal access tokens (PATs) are user-scoped tokens for scripts, CLI workflows, Workers, and tools that should act as one Notion user.”
• [claimed-docs] https://developers.notion.com“Internal connections are scoped to a single workspace and use a static API token. They're ideal for custom automations and workflows”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/mcp/hosting-open-source-mcp.md“If you need to run your own MCP server, the notion-mcp-server package is available as an open-source implementation.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Notion MCP lets an MCP client, such as Claude Code, Cursor, or Codex, connect to your Notion workspace through the Model Context Protocol (MCP).”
• [probe] https://developers.notion.com/openapi.json“PROBE openapi: HTTP 200 at https://developers.notion.com/openapi.json — contains "openapi" key”
• [probe] https://developers.notion.com/docs/mcp“official MCP server documented at https://developers.notion.com/docs/mcp”

Subscribe to events via webhooksweight 2

2 (weight) × 8 (quality) × 1.0 (full) = 16.0 of 20 max

• [claimed-docs] https://developers.notion.com“Connections can subscribe to real-time events — like page updates, property changes, and new comments — via webhooks.”
• [claimed-docs] https://developers.notion.com/reference/webhooks.md“Whenever a page or database changes, Notion sends a secure HTTP POST request to your webhook endpoint.”

Hand off work between tools or agents without losing context or informationweight 1

1 (weight) × 6 (quality) × 0.6 (partial) = 3.6 of 10 max

• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Find the Custom Agents your token can access, track their usage, and manage their status and credit limits.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Notion MCP lets an MCP client, such as Claude Code, Cursor, or Codex, connect to your Notion workspace through the Model Context Protocol (MCP).”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Search content in Notion and connected sources. * Read, create, and update Notion content. * Create pages and databases.”
• [claimed-docs] https://developers.notion.com“Connections can subscribe to real-time events — like page updates, property changes, and new comments — via webhooks.”
• [claimed-docs] https://developers.notion.com/reference/webhooks.md“Whenever a page or database changes, Notion sends a secure HTTP POST request to your webhook endpoint.”
• [probe] https://developers.notion.com/docs/mcp“official MCP server documented at https://developers.notion.com/docs/mcp”

Review AI agent code changes and comment on specific lines from a mobile app, then have the agent iterateweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Explore an interactive API reference with runnable examplesweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

• [probe] https://developers.notion.com/openapi.json“PROBE openapi: HTTP 200 at https://developers.notion.com/openapi.json — contains "openapi" key”
• [claimed-docs] https://developers.notion.com“create a personal access token, make your first API request, and see a new page appear in your workspace in under two minutes”
• [claimed-docs] https://developers.notion.com“With the REST API, you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more.”

Download a machine-readable API spec (OpenAPI or equivalent)weight 2

2 (weight) × 9 (quality) × 1.0 (full) = 18.0 of 20 max

• [probe] https://developers.notion.com/openapi.json“PROBE openapi: HTTP 200 at https://developers.notion.com/openapi.json — contains "openapi" key”
• [probe] https://developers.notion.com/llms.txt“PROBE llms.txt: HTTP 200 at https://developers.notion.com/llms.txt # Notion Docs - [Overview](https://developers.notion.com/guides/get-started/overview.md): Discover what Notion connecti”
• [claimed-docs] https://developers.notion.com“With the REST API, you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more.”

Test against a sandbox environment without touching production dataweight 1

1 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 10 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Rely on versioned APIs with a documented deprecation policyweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

The documented API rate limits and concurrency caps before building automation at scaleweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Do everything through the API that I can do in the UIweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

• [claimed-docs] https://developers.notion.com“With the REST API, you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more.”
• [claimed-docs] https://developers.notion.com“you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more”
• [probe] https://developers.notion.com/openapi.json“PROBE openapi: HTTP 200 at https://developers.notion.com/openapi.json — contains "openapi" key”
• [claimed-docs] https://developers.notion.com“Connections can subscribe to real-time events — like page updates, property changes, and new comments — via webhooks.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Search content in Notion and connected sources. * Read, create, and update Notion content. * Create pages and databases.”

Export all of my data in open formats and leaveweight 3

3 (weight) × 4 (quality) × 0.3 (disputed) = 3.6 of 30 max

• [claimed-docs] https://developers.notion.com“With the REST API, you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more.”
• [claimed-docs] https://developers.notion.com“create a personal access token, make your first API request, and see a new page appear in your workspace in under two minutes”
• [community] https://news.ycombinator.com/item?id=18904648“I've started using notion as a kind of personal wiki... My only issue with Notion is that I feel it's hard to get stuff out of it, especially on mobile.”
• [community] https://news.ycombinator.com/item?id=23236786“If I've understood it right... Notion is tied to its own cloud service for storing information, and there's no way to use it as a standalone app storing data locally... If yes, then this is not for me.”

Read the product's source under an open licenseweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

• [claimed-docs] https://developers.notion.com/guides/mcp/hosting-open-source-mcp.md“If you need to run your own MCP server, the notion-mcp-server package is available as an open-source implementation.”
• [community] https://news.ycombinator.com/item?id=43378239“For now I use Notion with the hopes they implement it eventually [offline read-only mode]. I can't consider switching to a self hosted alternative without the last point.”
• [community] https://news.ycombinator.com/item?id=23236786“If I've understood it right... Notion is tied to its own cloud service for storing information, and there's no way to use it as a standalone app storing data locally... If yes, then this is not for me.”

Self-host the core productweight 3

3 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 30 max

• [community] https://news.ycombinator.com/item?id=23236786“If I've understood it right... Notion is tied to its own cloud service for storing information, and there's no way to use it as a standalone app storing data locally... If yes, then this is not for me.”
• [community] https://news.ycombinator.com/item?id=43378239“For now I use Notion with the hopes they implement it eventually [offline read-only mode]. I can't consider switching to a self hosted alternative without the last point.”
• [community] https://news.ycombinator.com/item?id=26499062“I love Notion but the speed, or rather lack of, is killing me daily. Last Friday I was taking some notes, and suddenly the page refreshed and everything was gone... i feel like hosting my own notion clone is the way to go forward.”

Restore an AI coding agent's session to any previous checkpoint in its version historyweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Have a coding agent auto-detect and install the toolchains and dependencies it needs for a taskweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Have an agent verify its own implementation by navigating the app and capturing before-and-after screenshotsweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Get AI-generated insights and suggestions from my data inside the productweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

• [claimed-docs] https://notion.com“Get answers, instantly—with citations.”
• [claimed-docs] https://notion.com“Keep work moving 24/7 with agents.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Find the Custom Agents your token can access, track their usage, and manage their status and credit limits.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Search content in Notion and connected sources. * Read, create, and update Notion content. * Create pages and databases.”

Set up automations that run autonomously in the backgroundweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

• [claimed-docs] https://notion.com“Keep work moving 24/7 with agents.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Find the Custom Agents your token can access, track their usage, and manage their status and credit limits.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/quickstart.md“The connection can access only Custom Agents that are explicitly shared with it.”
• [claimed-docs] https://developers.notion.com“Connections can subscribe to real-time events — like page updates, property changes, and new comments — via webhooks.”
• [claimed-docs] https://developers.notion.com/reference/webhooks.md“Whenever a page or database changes, Notion sends a secure HTTP POST request to your webhook endpoint.”
• [claimed-docs] https://developers.notion.com“Internal connections are scoped to a single workspace and use a static API token. They're ideal for custom automations and workflows”
• [claimed-docs] https://developers.notion.com/guides/mcp/mcp-security-best-practices.md“Enable confirmation before actions that change content. This lets you review an action before the MCP client runs it.”

Delegate tasks to a built-in AI assistant inside the productweight 3

3 (weight) × 7 (quality) × 1.0 (full) = 21.0 of 30 max

• [claimed-docs] https://notion.com“Get answers, instantly—with citations.”
• [claimed-docs] https://notion.com“Keep work moving 24/7 with agents.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Find the Custom Agents your token can access, track their usage, and manage their status and credit limits.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/quickstart.md“The connection can access only Custom Agents that are explicitly shared with it.”

Operate the product with natural-language commandsweight 2

2 (weight) × 6 (quality) × 0.6 (partial) = 7.2 of 20 max

• [claimed-docs] https://notion.com“Get answers, instantly—with citations.”
• [claimed-docs] https://notion.com“Keep work moving 24/7 with agents.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Notion MCP lets an MCP client, such as Claude Code, Cursor, or Codex, connect to your Notion workspace through the Model Context Protocol (MCP).”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Search content in Notion and connected sources. * Read, create, and update Notion content. * Create pages and databases.”
• [claimed-docs] https://developers.notion.com/guides/mcp/notion-skills.md“A Notion Skill is a page you own with instructions for a repeatable workflow. You can maintain it yourself or ask an assistant to do it for you.”
• [probe] https://developers.notion.com/docs/mcp“official MCP server documented at https://developers.notion.com/docs/mcp”

Have AI break a code diff into focused sections with explanations of what changed and whyweight 2

n/a — not applicable to this product: excluded from numerator and denominator

no evidence cited — the verdict rests on absence of evidence, re-checked on refresh

Build and configure my own custom AI agent within the productweight 2

2 (weight) × 7 (quality) × 0.6 (partial) = 8.4 of 20 max

• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Find the Custom Agents your token can access, track their usage, and manage their status and credit limits.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/quickstart.md“The connection can access only Custom Agents that are explicitly shared with it.”
• [claimed-docs] https://notion.com“Keep work moving 24/7 with agents.”

Perform bulk operations across many items at onceweight 2

2 (weight) × 4 (quality) × 0.6 (partial) = 4.8 of 20 max

• [claimed-docs] https://developers.notion.com“With the REST API, you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more.”
• [claimed-docs] https://developers.notion.com“you can read, create, and update nearly everything in a workspace — pages, databases, users, comments, and more”
• [claimed-docs] https://developers.notion.com/guides/mcp/overview.md“Search content in Notion and connected sources. * Read, create, and update Notion content. * Create pages and databases.”
• [claimed-docs] https://developers.notion.com“create a personal access token, make your first API request, and see a new page appear in your workspace in under two minutes”

Define rules that trigger actions automatically on eventsweight 3

3 (weight) × 6 (quality) × 0.6 (partial) = 10.8 of 30 max

• [claimed-docs] https://developers.notion.com“Connections can subscribe to real-time events — like page updates, property changes, and new comments — via webhooks.”
• [claimed-docs] https://developers.notion.com/reference/webhooks.md“Whenever a page or database changes, Notion sends a secure HTTP POST request to your webhook endpoint.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Find the Custom Agents your token can access, track their usage, and manage their status and credit limits.”
• [claimed-docs] https://developers.notion.com“Internal connections are scoped to a single workspace and use a static API token. They're ideal for custom automations and workflows”

Schedule recurring jobs or workflowsweight 2

2 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 20 max

• [claimed-docs] https://developers.notion.com“Connections can subscribe to real-time events — like page updates, property changes, and new comments — via webhooks.”
• [claimed-docs] https://developers.notion.com/reference/webhooks.md“Whenever a page or database changes, Notion sends a secure HTTP POST request to your webhook endpoint.”
• [claimed-docs] https://developers.notion.com“Personal access tokens (PATs) are user-scoped tokens for scripts, CLI workflows, Workers, and tools that should act as one Notion user.”
• [claimed-docs] https://developers.notion.com“Internal connections are scoped to a single workspace and use a static API token. They're ideal for custom automations and workflows”

Version, review, and roll back my automationsweight 1

1 (weight) × 0 (quality) × 0.0 (none) = 0.0 of 10 max

• [claimed-docs] https://developers.notion.com/guides/mcp/mcp-security-best-practices.md“Enable confirmation before actions that change content. This lets you review an action before the MCP client runs it.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Use sessions to start a chat, stream the Agent's reply, submit an action when needed, and read its event history.”
• [claimed-docs] https://developers.notion.com/guides/notion-agent-apis/overview.md“Find the Custom Agents your token can access, track their usage, and manage their status and credit limits.”