Skip to content
MCP Servers

Notion MCP Server

Read, search, and write Notion pages and databases from any LLM client

8.4 / 10 38 Verified Reviewers Verified 2026-04-30 TypeScript · Notion API · MCP 1.0+

The Notion MCP server lets agents query databases, read page content, create new pages, and update existing pages. Maintained by the modelcontextprotocol org. Typical use cases: spec-writing agents that draft from templates, knowledge-base search that traverses linked pages, project-status digests pulled from a roadmap database. OAuth is per-user, scoped to the integration shared pages.

Pricing
Free · Open source (MIT) · Notion plan applies

Developer Consensus: Pros

  • Database query lets agents filter, sort, and join Notion data 31× mentioned
  • Page-create with proper block structure works on the first try 24× mentioned
  • Search across the whole workspace is fast 19× mentioned
  • OAuth scoping is conservative by default 13× mentioned

Common Friction Points

  • Notion API rate limits are tight — agents need to back off 14× mentioned
  • Block-structure JSON is verbose — eats context budget for long pages 11× mentioned
  • No native handling for synced blocks — they appear duplicated 8× mentioned
  • Notion API does not expose comments — agent cannot read inline discussion 6× mentioned

Verified Peer Reviews

@pm_agent
Product Manager · Mixed · Mid
Verified
Agent drafts spec docs from our template. I edit, not write.

We have a Notion template for product specs. The agent reads adjacent context (related projects, customer interviews) and drafts a v0.5 spec in our template. I edit it to v1.0 in 30 minutes instead of writing for 3 hours.

v0.3, April 2026 4.5/5 · 27 helpful
@kb_search
Engineering Lead · TypeScript · Mid
Verified
Search-across-workspace finally feels intelligent.

Notion search is keyword-only and shallow. With Claude and Notion MCP plus Context7 for code references, asking "what did we decide about X" returns the right pages with context, not just title matches.

v0.3, April 2026 4.4/5 · 18 helpful
@rate_limited
Platform Engineer · Python · Enterprise
Verified
Rate limits will hit you. Cache reads, queue writes.

Notion API allows 3 requests/sec/integration. An aggressive agent crosses that in seconds. We added Redis caching and a write queue. Now it is fine.

v0.3, March 2026 4/5 · 11 helpful

Compare to Alternatives

Methodology

Every review on this page is verified through GitHub OAuth and weighted by reviewer credibility, use-case match, and conflict-of-interest disclosure. Aggregate scores combine with recency decay so rankings reflect current reality. Read full methodology →