@notionhq/notion-mcp-server

Notion Official MCP Server by Notion

Official MCP server for Notion API

Live Registry Versionv2.5.2Previous: v2.5.1Published 2026-09-20

Stability Grade

B (78/100)

90-Day Velocity

1 releases

Stable release cadence

Dependencies

12 direct

NPM manifest

License

MIT

Verified on NPM

Recommended Exact Pin: npx -y @notionhq/notion-mcp-server@2.5.2

NPM Registry ->GitHub Repo ->

TL;DR Verdict & Quick Citation Summary (2026-10-24)Source: AgentBreakWatch Live NPM Index

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 past 90 days. v2.x replaces raw Notion-Version header config with simplified markdown block append payloads and OPENAPI_MCP_HEADERS env format. Production teams should pin npx -y @notionhq/notion-mcp-server@2.5.2 rather than using unpinned @latest tags.

Breaking Changes & Tool Schema Drift Analysis

v2.x replaces raw Notion-Version header config with simplified markdown block append payloads and OPENAPI_MCP_HEADERS env format.

Watched Exports / MCP Tool Signatures:

API-post-searchAPI-patch-block-childrenAPI-retrieve-a-page

Before (Deprecated / Unpinned Pattern)

"env": { "NOTION_API_TOKEN": "ntn_..." }

After (Verified v2.5.2 Pattern)

"env": { "NOTION_TOKEN": "ntn_..." }

Frequently Asked Questions: @notionhq/notion-mcp-server

What is the latest version of @notionhq/notion-mcp-server on NPM?

As of 2026-10-24, the latest stable version of @notionhq/notion-mcp-server (Notion Official MCP Server by Notion) on NPM is v2.5.2, published on 2026-09-20. It has shipped 1 releases in the last 90 days.

Does @notionhq/notion-mcp-server v2.5.2 have breaking changes or MCP schema drift risk?

@notionhq/notion-mcp-server currently carries a HIGH schema drift risk rating with a Stability Score of 78/100 (Grade B). v2.x replaces raw Notion-Version header config with simplified markdown block append payloads and OPENAPI_MCP_HEADERS env format.

How do I safely pin @notionhq/notion-mcp-server in production?

Avoid unpinned @latest tags in production agent configs. Pin the exact verified version using `npx -y @notionhq/notion-mcp-server@2.5.2` and monitor API-post-search, API-patch-block-children, API-retrieve-a-page for parameter or schema changes.

30-Min Registry & Schema Poller

Get Instant Breaking-Change Alerts for @notionhq/notion-mcp-server

We poll NPM and makenotion/notion-mcp-server every 30 minutes. Get an email with the exact diff when @notionhq/notion-mcp-server ships a breaking release beyond v2.5.2.