Notion MCP Integration

Notion MCP Integration

Notion MCP集成是一个轻量级的模型上下文协议(MCP)服务器,它与Notion的API无缝集成,通过Claude管理一个极简主义的个人待办事项列表。该项目提供了专门为简单Notion数据库结构定制的基本功能,使任务管理高效而不失简洁。

Notion MCP 集成快速开始指南

这个轻量级工具将 Claude 与 Notion 连接,帮助你使用 AI 管理待办事项列表。

演示

🚀 安装

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 .

⚙️ 配置

  1. 创建 Notion 集成:

  2. 共享数据库:

    • 在 Notion 中打开待办事项数据库
    • 点击 "..." → "添加连接" → 选择你的集成
  3. 创建 .env 文件:

    NOTION_API_KEY=your-api-key-here
    NOTION_DATABASE_ID=your-database-id-here
    
  4. 配置 Claude 桌面应用:

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

💡 使用指南

Claude 中可用的命令示例:

  • "显示我所有的待办事项"
  • "我今天的清单上有什么?"
  • "为今天添加一个待办事项:检查邮件"
  • "为以后添加一个任务:审查项目"

⚠️ 注意事项

  • 此工具设计用于具有特定结构的 Notion 数据库:
    • 任务(标题)
    • 时间(选项:"今天"或"以后")
    • 复选框(完成状态)
  • 查看示例数据库
  • 如需自定义,需修改 server.py 文件中的相关函数

📝 许可证

MIT 许可证 - 基于 danhilse/notion_mcp