Notion MCP Integration

What is Notion MCP Integration?

Notion MCP Integration is a simple Model Context Protocol (MCP) server that integrates with Notion’s API to manage a personal todo list through Claude. It is tailored for a minimalist Notion database structure with exactly four properties: Task (title), Checkbox, Description, and Link. It is based on the open-source project danhilse/notion_mcp.

How to use Notion MCP Integration?

Clone the repository, set up a Python virtual environment (Python 3.10+), and install with uv pip install -e .. Create a Notion integration, obtain an API key, and share your database with that integration. Configure a .env file with NOTION_API_KEY and NOTION_DATABASE_ID. Then either run the server directly with python -m notion_mcp or configure it in Claude Desktop’s claude_desktop_config.json to start automatically.

Key features of Notion MCP Integration

• Add new todo items with descriptions and links
• View all existing todos
• Mark tasks as complete
• Link external resources to tasks

Use cases of Notion MCP Integration

• Managing a personal minimalist todo list via Claude
• Quickly adding tasks with notes and URLs from conversation
• Checking off completed items without opening Notion
• Reviewing all pending tasks through a chat interface

FAQ from Notion MCP Integration

What database structure does this server require?

It requires a Notion database with exactly four properties: Task (title), Checkbox, Description, and Link. The code is tailored specifically for this schema.

Can I use this server with a different Notion database structure?

The README states that you will likely need to modify the code to match your own database structure and requirements. No support for complex or custom schemas is included.

What are the prerequisites?

Python 3.10 or higher, a Notion account, a Notion integration (API key), and a Notion database that matches the described structure (or willingness to modify the code).

How do I run the server?

You can run it directly from the command line with python -m notion_mcp (no output unless errors) or configure it in Claude Desktop to start automatically when Claude launches and stop when Claude is closed.

Are there any known limitations?

Yes: the server only works with a specific Notion database structure, has basic error handling, and does not support complex schemas, additional properties, recurring tasks, priorities, or tags.