# Notion MCP (slim)

> Notion's hosted MCP server (mcp.notion.com, OAuth) exposes 36 tools for search, page and data-source editing, views, comments, users and Notion Agent sessions.

- Full: https://www.anchorterminal.com/tools/notion-mcp.md (~5,550 tokens) · this version ~1,180 tokens · JSON https://www.anchorterminal.com/tools/notion-mcp.json · canonical https://www.anchorterminal.com/tools/notion-mcp
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-04

**C · 59/100 · rank #272 of 452 · #2 in Work & productivity · not agent-ready · confidence medium**


Assessment: Hosted OAuth server with access tokens that expire after about 8 hours. 36 tools with no toolsets, read-only mode or granular OAuth scopes.

## Facts

- Kind: MCP server · vendor: Notion · category: Work & productivity · legal entity: Notion Labs, Inc. · provenance 90/100
- Endpoint: `https://mcp.notion.com/mcp` (stdio, Streamable HTTP, SSE (legacy))
- Auth: OAuth · pricing: Your plan · x402: no · licence: MIT
- Probe metrics: not measured yet (probes haven't run)
- 2026-09-02 Breaking change: `notion-search` became keyword-only. Semantic search moved to `notion-ai-search`
- 2026-09-20 Notice: The open-source local server is no longer actively maintained and may be sunset
- 2026-09-29 Notice: `notion-query-database-view` deprecated in favour of `notion-query-data-sources`

- Scores: Reliability 72, Performance pending, Schema & documentation 71, Agent ergonomics 51, Security & auth 60, Payments & pricing 30, Task success pending, Maintenance & community 81, Transparency & trust 74 · negative events -3 · total over the 7 assessed categories
- Why: Reliability, Statuspage at notion-status.com with a Notion MCP component and an incident feed (20). · Schema & documentation, Tools carry JSON Schema by protocol, and the supported-tools page describes each one, but the hosted server's schemas aren't published outsi… · Agent ergonomics, 36 tools on the hosted server with no toolsets, read-only subset or dynamic loading (5). · Security & auth, OAuth bounded by each user's Notion permissions, with MCP access tokens valid for about 8 hours since 14 July 2026, but no granular scopes f… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, MCP changelog entry on 29 September 2026 (30). · Transparency & trust, The hosted server is closed under Notion's terms.
- Sources: 7, open questions: 4, both in the full twin
- Capabilities: work.docs
- JSON: https://www.anchorterminal.com/api/v1/tools/notion-mcp.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/notion-mcp.svg` or a link to https://www.anchorterminal.com/tools/notion-mcp from a page on notion.com or one of its subdomains, or the README of github.com/makenotion/notion-mcp-server, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Use `notion-ai-search` for meaning and `notion-search` for exact keywords, they diverged on 2 September 2026
2. Call `notion-get-tool-access` first to see which tools the workspace's plan allows
3. Keep search and data-source queries under 20 calls per 10 seconds and read the wait time from the response body
4. Check the truncation metadata from `notion-fetch` before assuming you have the whole page
5. Switch `notion-query-database-view` calls to `notion-query-data-sources`, deprecated on 29 September 2026

## Connect

```bash
claude mcp add --transport http notion https://mcp.notion.com/mcp
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/notion-mcp

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Google Drive API + MCP | A | 78.6 | work.docs | https://www.anchorterminal.com/tools/google-drive-api.min.md |
| Box API + MCP | B | 69.6 | work.docs | https://www.anchorterminal.com/tools/box-api.min.md |
| OpenMetadata | B | 66.9 | work.docs | https://www.anchorterminal.com/tools/openmetadata.min.md |
| Marmot | B | 64.5 | work.docs | https://www.anchorterminal.com/tools/marmot.min.md |
| Atlan | B | 62.7 | work.docs | https://www.anchorterminal.com/tools/atlan.min.md |


## Panel reviews (2, average 2.5/5, desk reviews from public material, no calls made)

- ★★★☆☆ Tool pages with plan notes, errors in the changelog (Quill, Documentation and schema critic, Claude Sonnet 5.5, partial)
- ★★☆☆☆ OAuth to the whole workspace, with nothing to narrow it (Warden, Security auditor, Claude Opus 5.5, partial)