notion-mcp-server
Official Notion MCP Server
The Notion MCP Server is an official implementation by Notion that exposes the Notion API to AI agents through the Model Context Protocol. It enables agents to read, write, and manage Notion pages, databases, and data sources programmatically. The server offers token-efficient Markdown endpoints for page content, supports both local and remote deployment options, and includes 22 tools covering search, comments, page operations, and data source management. Developers can authenticate with a Notion integration token and configure the server through popular AI clients like Claude Desktop, Cursor, or GitHub Copilot CLI.
Key Features
Use Cases
- 01Automating Notion page creation and updates through conversational AI interfaces
- 02Querying and filtering Notion databases via natural language commands in AI assistants
- 03Adding AI-generated comments and annotations to Notion pages during code review workflows
- 04Synchronizing project documentation between development tools and Notion workspaces
- 05Building AI agents that read meeting notes with transcripts and generate action items
- 06Deploying multi-tenant Notion integrations where each client uses their own API token
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.
notion-mcp-server — FAQ
What is the Notion MCP Server?+
It's an official Model Context Protocol server developed by Notion that connects AI agents to the Notion API, enabling them to read, write, search, and manage Notion pages, databases, and data sources through 22 specialized tools.
How do I install the Notion MCP Server in Claude Desktop or Cursor?+
Add a configuration entry to your claude_desktop_config.json or .cursor/mcp.json file that runs 'npx -y @notionhq/notion-mcp-server' with your NOTION_TOKEN environment variable. The server will then be available whenever you start the AI client.
Do I need a Notion API key or integration token?+
Yes, you must create an internal integration at notion.so/profile/integrations to obtain an integration token (starting with 'ntn_'). You also need to explicitly connect the integration to the Notion pages and databases you want the AI agent to access.
Which AI clients support this MCP server?+
The server works with Claude Desktop, Cursor, Zed, GitHub Copilot CLI, and any other client that implements the Model Context Protocol. Both STDIO and HTTP transport modes are supported for compatibility with desktop and web-based clients.
Is the Notion MCP Server free to use?+
Yes, the MCP server itself is open source and free. However, you need a Notion workspace and integration access, which may depend on your Notion plan (free, Plus, Business, or Enterprise).
What's the difference between the local and remote Notion MCP servers?+
Notion now offers a remote MCP server with OAuth setup and optimized AI tools that they actively support. This local/self-hosted server is still available but may be sunset in the future, and Notion is not actively monitoring issues or pull requests for it.
How do I install notion-mcp-server?+
Open the source repository on GitHub and follow its README. notion-mcp-server is a mcp server — MCP Agents Market links you directly to the official repo.
Is notion-mcp-server free?+
notion-mcp-server is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.