Gtd Notion MCP

Notion GTD MCP服务器

用于管理Notion中完成任务（GTD）的模型上下文协议（MCP）服务器。此服务器为Claude提供了有效管理任务跟踪系统的工具。

特性

核心GTD运营

• 按列表获取任务 -从特定的GTD列表中获取所有任务（收件箱、最高优先级、待办事项、某天、等待）
• 快速访问收件箱 -即时访问收件箱任务以进行每日评论
• 优先级任务管理 -获取所有具有截止日期的首要任务
• 移动任务 -在不同的GTD列表之间移动任务
• 批量更新 -在审核过程中同时更新多个任务
• 创建任务 -使用默认自动收件箱创建新任务

审查职能

• 每日回顾 -获取收件箱项目、今天的任务和过期任务（不包括已完成的任务）
• 每周回顾 -全面视图，包括所有列表、即将执行的任务和目标对齐（不包括已完成的任务）
• 基于目标的搜索 -查找与2025年特定目标相关的任务（不包括已完成的任务）

高级查询

• 逾期任务 -从活动列表中查找所有逾期的任务（不包括已完成的任务）
• 多过滤器搜索 -具有多个条件的复杂查询
• 任务查找器不完整 -查找缺少优先级或截止日期的任务

备注：所有查询都会自动从“完成”列表中排除任务，以专注于可操作的项目。

先决条件

• Python 3.10或更高版本
• 带有GTD任务数据库的Notion工作空间
• 通知API集成令牌
• Claude桌面应用程序

安装说明

1.克隆和设置项目

# Clone or create the project directory
cd notion-gtd-mcp

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
venv\Scripts\activate

# Install the package
pip install -e .

2.创建概念集成

1. 首选 https://www.notion.so/my-integrations
2. 点击“新建集成”
3. 给它起个名字：“GTD MCP服务器”
4. 选择您的工作区
5. 赋予它以下能力：

- 阅读内容 - 更新内容 - 插入内容

1. 复制内部集成令牌

3.将集成连接到数据库

1. 在Notion中打开“所有任务”数据库
2. 点击右上角的“…”菜单
3. 选择“添加连接”
4. 搜索并选择您的“GTD MCP服务器”集成
5. 如果您有“2025愿景和目标”页面，请重复该页面的过程

4.配置环境变量

1. 复制 env.template 向 .env:

   cp env.template .env

1. 编辑 .env 并添加您的值：

   NOTION_API_KEY=your_notion_integration_token_here
   NOTION_DATABASE_ID=25f2afc3-a6e4-463f-ad58-7810bc03aaea
   NOTION_GOALS_PAGE_ID=your_2025_goals_page_id_here

要查找您的数据库/页面ID：

- 在Notion中打开数据库/页面 - 请查看URL： https://notion.so/workspace/[DATABASE_ID]?v=[VIEW_ID] - 复制ID部分（在 ?)

5.测试服务器

# Make sure virtual environment is activated
python -m notion_gtd_mcp

您应该看到服务器启动时没有错误。

6.配置克劳德桌面

1. 查找您的Claude Desktop配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json

1. 编辑配置文件以添加MCP服务器：

{
  "mcpServers": {
    "notion-gtd": {
      "command": "/path/to/your/notion-gtd-mcp/venv/bin/python",
      "args": ["-m", "notion_gtd_mcp"],
      "cwd": "/path/to/your/notion-gtd-mcp",
      "env": {
        "NOTION_API_KEY": "your_notion_integration_token",
        "NOTION_DATABASE_ID": "25f2afc3-a6e4-463f-ad58-7810bc03aaea",
        "NOTION_GOALS_PAGE_ID": "your_goals_page_id"
      }
    }
  }
}

重要：替换 /path/to/your/notion-gtd-mcp 带有项目目录的实际路径。

7.重新启动克劳德桌面

保存配置后，完全退出并重新启动Claude Desktop。GTD工具现在应该可用。

使用示例

配置后，您可以要求Claude：

• “显示我的所有收件箱任务”
• “将任务\[ID\]移动到最高优先级”
• “创建新任务：审查第一季度财务报告”
• “显示我的每日评论”
• “获取所有逾期任务”
• “查找与我的健身目标相关的任务”
• “显示没有截止日期的首要任务”
• “批量将这5个任务移至待办事项列表”

数据库结构要求

您的Notion数据库应具有以下属性：

• 名字 （标题）-任务标题
• 列表 （选择）-选项：收件箱、最高优先级、待办事项、某天、等待
• 优先级 （选择）-选项：高、中、低
• 截止日期 （日期）-任务到期日
• 备注 （文本）-附加任务注释

故障排除

服务器无法启动

• 检查所有环境变量是否设置正确
• 验证您的Notion集成令牌是否有效
• 确保数据库ID正确

在Claude中看不到工具

• 确保配置路径指向虚拟环境中的Python可执行文件
• 检查手动运行时服务器是否成功启动
• 验证配置JSON是否有效（没有尾随逗号，引号正确）

任务未出现

• 确认集成已连接到Notion中的数据库
• 检查您的数据库是否具有所需的属性
• 验证列表名称是否完全匹配（区分大小写）

发展

要添加新功能或修改服务器，请执行以下操作：

1. 编辑 src/notion_gtd_mcp/server.py
2. 在中添加新工具 list_tools 方法
3. 在中实现工具逻辑 call_tool 方法
4. 根据需要添加辅助方法

许可证

本项目按原样提供供个人使用。