Notion MCP Integration

Notion MCP Integration

一个简单的MCP集成，允许Claude阅读和管理个人的Notion待办事项列表。

GitHub
Created Bydanhilsedanhilse

这个工具允许 Claude 通过 MCP 协议读取和管理您的 Notion 待办事项列表。

功能演示

重要说明

此工具专为特定结构的 Notion 待办事项列表设计，包含三个属性：

  • 任务（标题）
  • 时间（"今天"或"以后"）
  • 完成状态（复选框）

查看示例数据库

快速设置

  1. 克隆并安装

    git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .

  2. 设置 Notion 集成

    • 访问 Notion 集成页面
    • 创建新集成并复制 API 密钥
    • 将您的数据库共享给集成

  3. 配置环境

    • 创建 .env 文件: 
      NOTION_API_KEY=你的API密钥
NOTION_DATABASE_ID=你的数据库ID

  4. 配置 Claude Desktop

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

使用方法

向 Claude 发送以下命令:

  • "显示我所有的待办事项"
  • "我今天的清单是什么？"
  • "为今天添加一个待办事项：检查邮件"
  • "标记'检查邮件'为已完成"

手动启动服务器

如果需要手动启动服务器:

python -m notion_mcp

自定义

如需修改以适应不同数据库结构，编辑 server.py 文件中的:

  • create_todo() 函数
  • call_tool() 中的格式化逻辑
  • list_tools() 中的工具定义

限制

  • 仅支持特定的 Notion 数据库结构
  • 任务只能安排为"今天"或"以后"
  • 不支持复杂功能如重复任务、优先级或标签

许可证

MIT 许可证