Notion
A Notion integration that replaces low-level API calls with composite tools that speak Markdown instead of JSON blocks. The 9 tools expose 39+ actions across pages, databases, blocks, users, comments, and file uploads. Instead of chaining multiple endpoints to query a database then update properties, you call one tool with readable parameters. The server handles pagination and bulk operations internally, cutting token usage by about 77% through compressed descriptions. Ships with dual transport: stdio for local Claude Desktop use or streamable HTTP with OAuth 2.1 for remote setups. Useful when you want AI agents to manage Notion workspaces without wrestling with block arrays and manual cursor handling.
- GitHub stars
- 36
- tools
- 10
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Nov 12, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
pagesCreate, read, update, and organize pages
Create, read, update, and organize pages
No parameter schema in public metadata yet.
databasesDatabase CRUD and page management within databases
Database CRUD and page management within databases
No parameter schema in public metadata yet.
blocksRead and manipulate block content
Read and manipulate block content
No parameter schema in public metadata yet.
usersList and retrieve user information
List and retrieve user information
No parameter schema in public metadata yet.
workspaceWorkspace metadata and cross-workspace search
Workspace metadata and cross-workspace search
No parameter schema in public metadata yet.
commentsPage comments and discussion replies
Page comments and discussion replies
No parameter schema in public metadata yet.
content_convertConvert between Markdown and Notion blocks (uses a `direction` parameter)
Convert between Markdown and Notion blocks (uses a `direction` parameter)
No parameter schema in public metadata yet.
file_uploadsUpload files to Notion (single or multi-part)
Upload files to Notion (single or multi-part)
No parameter schema in public metadata yet.
configInspect and manage credential state and configuration lifecycle
Inspect and manage credential state and configuration lifecycle
No parameter schema in public metadata yet.
helpGet full documentation for any composite tool (`tool_name` parameter)
Get full documentation for any composite tool (`tool_name` parameter)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
NOTION_TOKEN*secretNotion integration token. Create at https://www.notion.so/my-integrations
Readme
notion
mcp-name: io.github.n24q02m/notion
Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.
Details
- Repository
- github.com/n24q02m/notion
- Category
- Documents & Knowledge
- Package
@n24q02m/notion- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from n24q02m
Related Documents & Knowledge MCP servers
View all
Zotero Bridgecombjellyshen/zoterobridgeMCP Server for Zotero SQLite Database - collection, tagging, PDF reading and more.10stars
Pdf Itmrslbt/pdf-itNative PDF renderer for AI markdown. Cover, TOC, page-numbered footer. Fonts embedded, zero config.2stars
Notion Mcpshck-dev/notion-mcpNotion MCP server — search, export, and import pages as markdown2stars
Slipstack PDFdev.slipstack/pdfGenerate invoice and receipt PDFs from JSON. Agent-callable document API with a free demo quota.0stars
PDF Generator APIbr0ski777/pdf-generator-x402Generate PDF from HTML or Markdown with custom pages, margins, layout. x402.0stars
Obsidian Mcp Servercyanheads/obsidian-mcp-serverRead, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.705stars