Notion MCP 集成

一个简单的模型上下文协议 (MCP) 服务器，与 Notion 的 API 集成，通过 Claude 管理我的个人待办事项列表。 这是一个基本的实现，专门为我在 Notion 中极简的待办事项列表设置而定制。

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

重要提示

这是一个个人项目，专为非常特定的用例而设计：我简单的 Notion 待办事项列表，只有三个属性：

• 任务（标题）
• 时间（选择，只有两个选项：“今天”或“稍后”）
• 复选框（标记是否完成）

示例 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 的基本命令：

• "Show all my todos" (显示我所有的待办事项)
• "What's on my list for today?" (我今天有什么任务？)
• "Add a todo for today: check emails" (添加一个今天的待办事项：检查电子邮件)
• "Add a task for later: review project" (添加一个稍后的任务：审查项目)

局限性

• 仅适用于特定的 Notion 数据库结构
• 不支持复杂的数据库模式
• 仅限于“今天”或“稍后”的任务安排
• 不支持其他属性或自定义字段
• 基本的错误处理
• 没有高级功能，如重复任务、优先级或标签

自定义

如果你想将其用于不同的数据库结构，你需要修改 server.py 文件，特别是：

• create_todo() 函数以匹配你的数据库属性
• call_tool() 中的待办事项格式以处理你的数据结构
• 如果你想要不同的选项，则修改 list_tools() 中的输入模式

项目结构

notion_mcp/
├── pyproject.toml
├── README.md
├── .env                   # 不包含在 repo 中
└── src/
    └── notion_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # 主要实现

许可证

MIT 许可证 - 使用风险自负

致谢

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