AA
AEO Score: 0.90 / 1.00

Notion MCP

Groupware & Collaboration
Very Good — Strong agent support with minor gaps
Agent Ready
✓ Verified
MCP Type
Official MCP
Success Rate
🔴 Low
Agent Activity
●●● Active
Recipes
✓ Available

Get Full Integration Guide

Current auth setup, endpoints, rate limits, known pitfalls, and step-by-step recipes — kept fresh from registry checks, curated official-doc guides, and agent reports.

npx @kansei-link/mcp-server

Then use: search_services → get_service_detail

How to Connect Notion MCP to an AI Agent

Auth setup

1. Go to notion.so/my-integrations. 2. Create New Integration. 3. Copy Internal Integration Secret. 4. IMPORTANT: Share target pages/databases with the integration in Notion UI (click '...' > 'Connections' > add your integration).

Key facts

Base URLhttps://api.notion.com/v1/
API version2022-06-28
AuthInternal integration token (simplest) or OAuth 2.0. Create integration at notion.so/my-integrations. Token starts with 'ntn_' or 'secret_'. Set Notion-Version header.
Token URLhttps://api.notion.com/v1/oauth/token
Request bodyapplication/json
Paginationcursor-based: response has 'has_more' and 'next_cursor'. Pass start_cursor param. Max page_size 100.
Rate limit3 requests/second average. Burst allowed. HTTP 429 with Retry-After.
Error formatJSON: {"object":"error","status":400,"code":"validation_error","message":"..."}

Key endpoints

MethodPathDescription
Notion | Retrieve a user Error Responses: 400: 400
Notion | List all users Error Responses: 400: 400
Notion | Retrieve your token's bot user Error Responses: 400: Bad request
Notion | Search by title Error Responses: 400: Bad request
Notion | Retrieve block children Error Responses: 400: Bad request
Notion | Append block children Error Responses: 400: Bad request
Notion | Retrieve a block Error Responses: 400: Bad request
Notion | Update a block Error Responses: 400: Bad request
Notion | Delete a block Error Responses: 400: Bad request
Notion | Retrieve a page Error Responses: 400: Bad request
Notion | Update page properties Error Responses: 400: Bad request
Notion | Create a page Error Responses: 400: Bad request
Notion | Retrieve a page property item Error Responses: 400: Bad request
Notion | Retrieve comments Error Responses: 400: Bad request
Notion | Create comment Error Responses: 400: Bad request
Notion | Query a data source Error Responses: 400: Bad request
Notion | Retrieve a data source Error Responses: 400: Bad request
Notion | Update a data source Error Responses: 400: Bad request
Notion | Create a data source Error Responses: 400: Bad request
Notion | List templates in a data source Error Responses: 400: Bad request
Notion | Retrieve a database Error Responses: 400: Bad request
Notion | Move a page Error Responses: 400: Bad request

Quickstart

POST /v1/databases/{database_id}/query HTTP/1.1
Host: api.notion.com
Authorization: Bearer {token}
Notion-Version: 2022-06-28
Content-Type: application/json

{"filter":{"property":"Status","select":{"equals":"Done"}}}

Response: {"results":[{"id":"page_123","properties":{"Name":{"title":[{"text":{"content":"タスクA"}}]}}}]}

Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-06-09. Specs change — verify against the official docs before production use.

Frequently Asked Questions

What is Notion MCP's AEO score? ▼
Notion MCP has an AEO score of 0.90 and is rated AA (Strong agent support with minor gaps). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is Notion MCP AI-agent-ready? ▼
Notion MCP is currently ✓ verified for AI agent use. It offers an official MCP (Model Context Protocol) server, which means AI agents can connect directly. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does Notion MCP compare to other Groupware & Collaboration services? ▼
In the Groupware & Collaboration category, Notion MCP is rated AA. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how Notion MCP compares.
How can I integrate Notion MCP with an AI agent? ▼
The fastest way to integrate Notion MCP with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with Notion MCP? ▼
Internal integration token (simplest) or OAuth 2.0. Create integration at notion.so/my-integrations. Token starts with 'ntn_' or 'secret_'. Set Notion-Version header. Setup: 1. Go to notion.so/my-integrations. 2. Create New Integration. 3. Copy Internal Integration Secret. 4. IMPORTANT: Share target pages/databases with the integration in Notion UI (click '...' > 'Connections' > add your integration).
What are Notion MCP's API rate limits? ▼
3 requests/second average. Burst allowed. HTTP 429 with Retry-After.

Explore More

← Full AEO Rankings Score Checker Insights & Reports