Notion MCP 集成

一个简单的 Model Context Protocol (MCP) 服务器，与 Notion 的 API 集成，用于通过 Claude 管理我的个人待办事项列表。此实现是为我 minimalist 的 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  # Windows 使用：.venv\Scripts\activate
uv pip install -e .

3. 创建 Notion 集成：

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

4. 与你的数据库共享集成：

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

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 启动时启动
• 请参考 Claude Documentation 了解详细信息

使用说明

• 在 Notion 中创建一个包含待办事项的数据库，并确保它与你的 .env 配置匹配
• 启动服务器，然后通过 Claude 调用 MCP 接口来管理你的待办事项

注意事项

• 此项目目前仅支持基本的 CRUD 操作
• 请根据你的需求扩展功能
• 如有错误或问题，请检查日志或重新审视配置

项目结构

notion-mcp/
├── server.py       # 主服务器文件
├── config.py      # 配置和环境变量
└── README.md      # 项目文档

感谢使用 Notion MCP 集成！如果有任何问题或建议，请随时提出。