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
📓 GistPad MCP
lostintangent📓 An MCP server for managing your personal knowledge, daily notes, and re-usable prompts via GitHub Gists
Ultimate Google Docs & Drive MCP Server
a-bonusThe Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.
Context7 MCP - Up-to-date Docs For Any Cursor Prompt
upstashContext7 Platform -- Up-to-date code documentation for LLMs and AI code editors
Anytype MCP Server
anyprotoAn MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.
Dash Api Docs Mcp Server
KapeliMCP server for Dash, the macOS API documentation browser
Comments