Notion MCP 集成

一个简单的模型上下文协议（MCP）服务器，它与Notion API集成，通过Claude管理我的个人待办事项列表。这是一个专门针对我在Notion中设置的极简主义待办事项列表的基本实现。

本项目基于danhilse/notion_mcp，该库在MIT许可下可用。

<p align="center"> <img src="assets/demo.gif" width="600"/> </p>

重要提示

这是一个专为特定用途设计的个人项目：我的简单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  # 在Windows上使用：.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. 直接从命令行运行：

# 在激活虚拟环境的项目目录中
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                   # 不包含在仓库中
└── src/
    └── notion_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # 主要实现

许可证

MIT许可证 - 自行承担风险

致谢

• 为与Claude Desktop配合工作而构建
• 使用Notion的API