
Notion
The Mcp Notion Server enables large language models to interact with Notion workspaces through the Notion API, providing tools for retrieving pages, querying databases, searching content, and managing users and comments. It converts Notion content to Markdown format to reduce token consumption and optimize context size when communicating with LLMs. The server requires authentication via a Notion integration token and supports selective tool enabling and optional Markdown conversion modes.
- GitHub stars
- 892
- tools
- 9
- last updated
- Mar 1, 2026
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
notion_findLocates a page or data source in the workspace.
Locates a page or data source in the workspace.
No parameter schema in public metadata yet.
notion_read_pageReads compact page content with stable block IDs.
Reads compact page content with stable block IDs.
No parameter schema in public metadata yet.
notion_inspect_data_sourceInspects a data source schema before querying or creating items.
Inspects a data source schema before querying or creating items.
No parameter schema in public metadata yet.
notion_query_data_source_by_valuesQueries a data source using simple values.
Queries a data source using simple values.
No parameter schema in public metadata yet.
notion_create_data_source_item_from_valuesCreates a data source item from simple values.
Creates a data source item from simple values.
No parameter schema in public metadata yet.
notion_append_markdownAppends Markdown content to a page safely.
Appends Markdown content to a page safely.
No parameter schema in public metadata yet.
notion_append_contentAppends content blocks to a page.
Appends content blocks to a page.
No parameter schema in public metadata yet.
notion_update_contentUpdates a single block's content.
Updates a single block's content.
No parameter schema in public metadata yet.
notion_update_content_batchUpdates multiple blocks' content in one batch.
Updates multiple blocks' content in one batch.
No parameter schema in public metadata yet.
Sponsors
Readme
Notion MCP Server
AI-friendly MCP server for the Notion API. It helps agents find, read, query, and update Notion workspaces while keeping responses compact enough for day-to-day AI workflows.
This server targets the Notion API 2026-03-11 and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.
Highlights
- Search and target discovery with
notion_find. - Compact page reading with stable block IDs via
notion_read_page. - Data source schema inspection with
notion_inspect_data_source. - Schema-aware data source querying and item creation with simple values.
- Simple page editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers, and safe Markdown append.
- Raw Notion API tools for advanced block, page, database, data source, comment, and user operations.
- Optional MCP Apps: Data Source Explorer and Page Workbench.
Quick Start
Add this server to an MCP host such as Claude Desktop:
Details
- Repository
- github.com/suekou/mcp-notion-server
- Category
- Documents & Knowledge