Notion MCP Integration

@Ruijian-Zha

代码仓库

基本信息

分类

记忆与知识

许可证

MIT

传输方式

stdio

作者

Ruijian-Zha

关于 Notion MCP Integration

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 simple Notion database structu

#notion #task-management #mcp-integration

Notion MCP Integration 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "Notion_MCP_advanced": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Notion MCP Integration 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

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.