# Notion Official MCP Server (@notionhq/notion-mcp-server) - AgentBreakWatch Reference

> TL;DR Verdict: Notion Official MCP Server (`@notionhq/notion-mcp-server`) is currently at v2.5.2 on NPM (published 2026-09-20), with a 90-day Stability Score of 78/100 (B) and HIGH schema drift risk across 1 releases in the last 90 days. v2.x replaces raw Notion-Version header config with simplified markdown block append payloads and OPENAPI_MCP_HEADERS env format.

## Live Telemetry Metadata
- Canonical Page: https://agentbreakwatch.vercel.app/p/notion-mcp
- Category Hub: https://agentbreakwatch.vercel.app/c/productivity-docs (Productivity, Notion, Slack, Jira & Docs MCP Servers)
- Package Name: `@notionhq/notion-mcp-server`
- Registry: NPM (https://www.npmjs.com/package/@notionhq/notion-mcp-server)
- GitHub Repository: https://github.com/makenotion/notion-mcp-server
- Vendor: Notion
- Latest Live Version: v2.5.2
- Published Date: 2026-09-20T23:10:37.446Z
- 90-Day Release Count: 1
- Direct Dependencies: 12
- License: MIT
- Stability Score: 78/100 (Grade B)
- Schema Drift Risk: HIGH
- Recommended Exact Pin Command: `npx -y @notionhq/notion-mcp-server@2.5.2`
- Watched Symbols / MCP Tools: API-post-search, API-patch-block-children, API-retrieve-a-page
- Snapshot Timestamp: 2026-10-24T12:11:27.697Z

## Breaking Change & Schema Drift Summary
v2.x replaces raw Notion-Version header config with simplified markdown block append payloads and OPENAPI_MCP_HEADERS env format.

## Migration Diff: Before (Deprecated / Unpinned Pattern)
```
"env": { "NOTION_API_TOKEN": "ntn_..." }
```

## Migration Diff: After (Verified v2.5.2 Pattern)
```
"env": { "NOTION_TOKEN": "ntn_..." }
```

## Recent Verified Releases
- v2.5.2 (published 2026-09-20) [LATEST]
- v2.5.1 (published 2026-07-25)
- v2.5.0 (published 2026-07-24)
- v2.4.1 (published 2026-06-22)
- v2.4.0 (published 2026-06-17)
- v2.3.1 (published 2026-06-17)