Notion
Notion MCP Integration is a lightweight Model Context Protocol (MCP) server that seamlessly integrates with Notion's API to manage a minimalist personal to-do list through Claude. This project provides basic functionality tailored specifically for a
What is Notion?
Notion is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to notion mcp integration is a lightweight model context protocol (mcp) server that seamlessly integrates with notion's api to manage a minimalist personal to-do list through claude. this project provide...
Notion MCP Integration is a lightweight Model Context Protocol (MCP) server that seamlessly integrates with Notion's API to manage a minimalist personal to-do list through Claude. This project provides basic functionality tailored specifically for a
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Notion MCP Integration is a lightweight Model Context Protoc
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx notion-mcp-advancedConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Notion
Notion MCP Advanced is a lightweight Python MCP server that connects Claude to a personal Notion database for managing a to-do list through natural language. It wraps the Notion API to support adding tasks with optional descriptions and links, viewing all todos, and marking items complete — designed for a specific Notion database schema with Task, Checkbox, Description, and Link properties.
Prerequisites
- Python 3.10+ installed
- A Notion account with an internal integration created at https://www.notion.so/my-integrations
- A Notion database with properties: Task (title), Checkbox (checkbox), Description (rich text), Link (URL)
- The integration connected to your database (share the database with the integration in Notion)
- Claude Desktop installed
Clone the repository
Clone the Notion MCP Advanced repository and navigate into it.
git clone https://github.com/Ruijian-Zha/Notion_MCP_advanced.git
cd Notion_MCP_advancedCreate and activate a virtual environment
Use a virtual environment to isolate the project's Python dependencies.
python -m venv .venv
# macOS/Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activateInstall dependencies
Install the package and its dependencies using uv pip or standard pip.
# With uv (recommended)
uv pip install -e .
# Or with standard pip
pip install -e .Set environment variables
Create a .env file in the project root with your Notion API key and the database ID. Find the database ID in the Notion page URL: notion.so/username/<DATABASE_ID>?v=...
# .env file contents
NOTION_API_KEY=secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
NOTION_DATABASE_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxConfigure Claude Desktop
Add the server to claude_desktop_config.json pointing at the virtual environment Python binary.
{
"mcpServers": {
"notion-todo": {
"command": "/path/to/Notion_MCP_advanced/.venv/bin/python",
"args": ["-m", "notion_mcp"],
"cwd": "/path/to/Notion_MCP_advanced",
"env": {
"NOTION_API_KEY": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"NOTION_DATABASE_ID": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Notion Examples
Client configuration
Full claude_desktop_config.json entry for the Notion todo MCP server with credentials passed in the env block.
{
"mcpServers": {
"notion-todo": {
"command": "/home/user/Notion_MCP_advanced/.venv/bin/python",
"args": ["-m", "notion_mcp"],
"cwd": "/home/user/Notion_MCP_advanced",
"env": {
"NOTION_API_KEY": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"NOTION_DATABASE_ID": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}Prompts to try
Natural-language prompts for managing your Notion to-do list through Claude.
- "Show all my todos"
- "Add a todo: review the Q2 budget spreadsheet"
- "Add a todo: read the new API docs, with link: https://developers.notion.com/docs"
- "Mark the task 'review Q2 budget' as complete"
- "How many todos do I have and which are still unchecked?"Troubleshooting Notion
401 Unauthorized from Notion API
Verify NOTION_API_KEY is set to a valid internal integration token starting with 'secret_'. Also confirm the integration has been explicitly connected to the target database: open the database in Notion, click the three-dot menu, go to Connections, and add your integration.
Database not found or empty results even though data exists
The NOTION_DATABASE_ID must be the bare 32-character ID without hyphens. Copy it from the Notion page URL and remove any hyphens. Also confirm the integration has access to that specific database page.
Server starts but tools fail because the database schema is wrong
The server expects specific property names and types: a 'Task' title property, a 'Checkbox' checkbox property, a 'Description' rich text property, and a 'Link' URL property. Create these properties in your Notion database with matching exact names and types.
Frequently Asked Questions about Notion
What is Notion?
Notion is a Model Context Protocol (MCP) server that notion mcp integration is a lightweight model context protocol (mcp) server that seamlessly integrates with notion's api to manage a minimalist personal to-do list through claude. this project provides basic functionality tailored specifically for a It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Notion?
Follow the installation instructions on the Notion GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Notion?
Notion works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Notion free to use?
Yes, Notion is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Notion Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Notion? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Notion in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Notion?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.