Notion MCP Server
@suekou
About Notion MCP Server
A Model Context Protocol server for connecting Notion to MCP-compatible clients
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "your-integration-token"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Notion MCP Server?
Notion MCP Server is an MCP (Model Context Protocol) server for the Notion API (version 2026-03-11) that helps AI agents find, read, query, and update Notion workspaces while keeping responses compact for AI workflows. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.
How to use Notion MCP Server?
Install by adding the server configuration to an MCP host (e.g., Claude Desktop) using npx -y @suekou/mcp-notion-server and setting the NOTION_API_TOKEN environment variable. Create a Notion internal integration, grant the required capabilities (read, insert, update content), share target pages/databases with the integration, and copy the integration token. After saving the configuration, restart the MCP host.
Key features of Notion MCP Server
- 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.
Use cases of Notion MCP Server
- Agents searching for pages and reading their content with stable block IDs.
- Querying and updating database or data source items using schema-aware tools.
- Editing page content with simple editing tools (paragraphs, headings, lists, etc.).
- Performing advanced operations using raw Notion API tools.
- Interactively exploring data sources and page structure with MCP Apps.
FAQ from Notion MCP Server
What runtime dependencies does Notion MCP Server have?
For usage, only an MCP host is required. For development, Node.js 22 or newer and pnpm are needed.
How does authentication work?
Authentication uses a Notion internal integration token set as the NOTION_API_TOKEN environment variable in the MCP host configuration.
Which Notion API version does it support?
It targets the Notion API version 2026-03-11.
What are the content access limitations?
Notion only allows an integration to access pages and databases that have been explicitly shared with it, either via the integration’s Content access tab or from the page/database Connections menu.
What transport does it use?
It uses standard MCP stdio transport, as configured with the command and args in the MCP host settings.
More Memory & Knowledge MCP servers
Notion MCP Server
awkoyNotion MCP server for Claude, Cursor, ChatGPT & Claude Desktop. Connect AI agents to Notion via Model Context Protocol — pages, databases, blocks, comments, files.
Obsidian MCP Server
StevenStavrakisA simple MCP server for Obsidian
Context Portal MCP (ConPort)
GreatScottyMacContext Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.
Memory
modelcontextprotocolModel Context Protocol Servers
Context7 MCP - Up-to-date Docs For Any Cursor Prompt
upstashContext7 Platform -- Up-to-date code documentation for LLMs and AI code editors
Comments