BrowseFull catalogOutcomesSolve a specific problemRolesStack by teamTrustFilter by risk tier
← Back to the Claude Observatory

better-notion-mcp

Connector Documents & Content Usable
Works inClaude Code Claude Cowork Claude Chat
Usable Scanned — metadata only

Enables AI agents to read, write, and manage Notion databases as markdown, reducing friction in documentation workflows and allowing autonomous agents to mai…

Markdown-first MCP server for the Notion API: agents read and write pages, databases, blocks, and comments in one call, working in markdown instead of raw Notion block JSON. Runs via npx (Node.js 24+) with a Notion integration token, or as a published Docker image over stdio.

36 starsApache-2.0 (commercial OK)FreeNo code needed
Usable rating — This tool is functional but has notable gaps. Review the evaluation notes below before deploying.

Enables AI agents to read, write, and manage Notion databases as markdown, reducing friction in documentation workflows and allowing autonomous agents to maintain organizational knowledge without manual API integration.

Engineering teams using Notion for documentation, specs, or runbooks who want AI agents to autonomously update and retrieve structured content.

Claude Code Claude Cowork Claude Chat

https://github.com/n24q02m/better-notion-mcp

By n24q02m

How to Get It

Option 1: Claude Desktop AppOpen the Customize panel in the sidebar → browse connectors → search and add. Works in Claude Code, Claude Cowork, and Claude Chat.
Option 2: Paste into Claude CodeCopy the command below and paste it into a Claude Code conversation. Claude will run it for you.
Command
claude mcp add better-notion-mcp -e NOTION_TOKEN=ntn_your_token_here -- npx -y @n24q02m/better-notion-mcp@latest

Tip: Paste this into a Claude Code conversation. Verify command matches your Claude Code version.

First thing to try

Once it’s connected, paste this into Claude:

Help me extract structured data from Notion databases for reports
PrerequisitesNode.js >= 24 (runs via npx) or Docker; a Notion internal integration token (starts with ntn_) from notion.so/my-integrations, with the integration shared to the pages/databases you want it to access.CostFree

Trust Signals Auto-scanned

Stars36Contributors10Last updated2026-08-16LicenseApache-2.0 (OK for commercial use)Known CVEsNone foundSources: GitHub Advisory Database + OSV.dev · Scanned 2026-08-17 · scanner v1

Data & Access

Data processingPrompts sent to Anthropic API. Enterprise/Team plans exclude training.

Community Pulse Growing

Discussed on Reddit

2 mentions across 1 sources

Reviewer notes

Auto-scanned review. These are observations, not a security certification.

Auto-assessment from April sweep — baseline scores pending hands-on review.

2026-04-18: Approved in April sweep: New and small but has a clear description and recent commits — worth tracking.

Things to check

  • Requires valid Notion API token and database/page IDs; Notion API rate limits apply and may throttle high-volume operations. Markdown conversion may lose some Notion-specific formatting like synced blocks or database relations.

How to evaluate tools before deploying →

Data shown here comes from public APIs and automated scanning. Reviewer notes reflect one person's experience. This is not a security certification or legal recommendation. Always evaluate tools according to your own organization's policies.

Evaluation

Ease of Use
3/5
Versatility
3/5
Reliability
3/5
Security
3/5
Overall score3.00 / 5.00 UsableEvaluatedApr 2026

← Back to the Claude Observatory

Rolling Claude out in your org? Let's talk.

Start a conversation →