Notion MCP Integration

Notion MCP 集成

一个简单的 Model Context Protocol（MCP）服务，可集成 Notion API，让我通过 Claude 管理个人待办事项列表。这是一个基础实现，专为我在 Notion 中的极简待办事项列表设置量身打造。

本项目基于 danhilse/notion_mcp，该项目采用 MIT 许可证。

重要说明

这是一个个人项目，专为非常具体的使用场景设计：我在 Notion 中的简单待办事项列表，仅包含四个属性：

• 任务（标题）
• 复选框（标记是否已完成）
• 描述（补充详情）
• 链接（URL 或参考资料）

Notion 数据库示例

你可以将其作为自己 Notion 集成的起点，但很可能需要修改代码，以匹配自己的数据库结构和需求。

功能

• 添加带有描述和链接的新待办事项
• 查看所有待办事项
• 将任务标记为已完成
• 为任务关联外部资源

前提条件

• Python 3.10 或更高版本
• Notion 账户
• Notion 集成（API 密钥）
• 符合上述确切结构的 Notion 数据库（或愿意根据自己的结构修改代码）

设置

1. 克隆代码仓库：

git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp

2. 设置 Python 环境：

python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
uv pip install -e .

3. 创建 Notion 集成：

   • 前往 https://www.notion.so/my-integrations
   • 创建新的集成
   • 复制 API 密钥

4. 与集成共享数据库：

   • 在 Notion 中打开待办事项数据库
   • 点击“...”菜单 →“添加连接”
   • 选择你的集成

5. 创建 .env 文件：

NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here

6. 配置 Claude Desktop：

{
  "mcpServers": {
    "notion-todo": {
      "command": "/path/to/your/.venv/bin/python",
      "args": ["-m", "notion_mcp"],
      "cwd": "/path/to/notion-mcp"
    }
  }
}

运行服务

服务可以通过两种方式运行：

1. 直接从命令行运行：

# From the project directory with virtual environment activated
python -m notion_mcp

2. 通过 Claude Desktop 自动运行（推荐）：

• 如果在 claude_desktop_config.json 中正确配置，Claude 启动时服务将自动启动
• 无需手动管理服务
• 关闭 Claude 时服务会停止

注意：直接运行时，除非发生错误，否则服务不会显示任何输出——这是正常现象，因为它正在等待 MCP 命令。

用法

通过 Claude 执行的基本命令：

• “显示我的所有待办事项”
• “添加待办事项：检查邮件”
• “添加待办事项：审阅项目文档，并附上链接：https://example.com/docs”
• “将待办事项 [ID] 标记为已完成”

限制

• 仅适用于特定的 Notion 数据库结构
• 不支持复杂的数据库架构
• 错误处理较为基础
• 不支持其他属性或自定义字段
• 不支持重复任务、优先级或标签等高级功能

项目结构

notion_mcp/
├── pyproject.toml
├── README.md
├── .env                   # Not included in repo
└── src/
    └── notion_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # Main implementation

许可证

MIT 许可证——使用风险自负

致谢

• 专为配合 Claude Desktop 使用而构建
• 使用 Notion API