mcp-notion-server
A Model Context Protocol server for connecting Notion to MCP-compatible clients
The Notion MCP server connects AI assistants to Notion workspaces through the Model Context Protocol, enabling agents to search, read, query, and modify Notion pages and databases. Built for the Notion API version 2026-03-11, it provides both simplified tools for common tasks and raw API access for advanced operations. The server includes optional interactive MCP Apps like Data Source Explorer and Page Workbench for streamlined workflows. Developers add it to MCP-compatible clients via npx, configure a Notion integration token, and grant workspace permissions.
Key Features
Use Cases
- 01Enabling AI assistants to search and retrieve information from Notion knowledge bases
- 02Automating page creation and updates in Notion project databases through conversational AI
- 03Querying Notion databases and data sources to answer questions about structured workspace data
- 04Appending meeting notes, task lists, or documentation to existing Notion pages via AI agents
- 05Migrating or synchronizing content between Notion and other systems using AI-assisted workflows
- 06Building interactive Notion management interfaces within MCP-compatible AI clients
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
mcp-notion-server — FAQ
What is the Notion MCP server?+
The Notion MCP server is a Model Context Protocol implementation that connects AI assistants like Claude to Notion workspaces, allowing agents to search, read, query, and modify Notion pages and databases through standardized tools.
How do I install the Notion MCP server in Claude Desktop?+
Add a configuration entry to your Claude Desktop MCP settings file with the command 'npx', args '["-y", "@suekou/mcp-notion-server"]', and set the NOTION_API_TOKEN environment variable to your Notion integration secret. Restart Claude Desktop after saving the configuration.
Which MCP clients work with this Notion server?+
The Notion MCP server works with any MCP-compatible client, including Claude Desktop, Cursor, and other hosts that support the Model Context Protocol.
Do I need a Notion API token to use this server?+
Yes, you must create an internal Notion integration through the Notion integrations dashboard, configure its capabilities, grant it access to specific pages or databases, and copy the integration secret to use as NOTION_API_TOKEN.
Is the Notion MCP server free to use?+
Yes, the server is open source and licensed under the MIT License, allowing free use, modification, and distribution. You'll need a Notion account with appropriate workspace permissions.
What permissions does my Notion integration need?+
At minimum, enable 'Read content' for search and queries. Add 'Insert content' for creating pages/items, 'Update content' for modifications, and optionally 'Read comments', 'Insert comments', or 'User information' if you need those specific tools.
How do I install mcp-notion-server?+
Open the source repository on GitHub and follow its README. mcp-notion-server is a mcp server — MCP Agents Market links you directly to the official repo.
Is mcp-notion-server free?+
mcp-notion-server is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.