Reclaim.ai MCP Server 🚀(UNOFFICIAL)
Overview
基本能力
产品定位
Reclaim.ai MCP Server 是一个社区维护的 MCP 服务器，用于通过标准化的协议与 Reclaim.ai API 交互，提供任务管理和时间跟踪功能。
核心功能
- Active-tasks 资源 (
tasks://active) - 14 种任务操作工具（列表、创建、更新、完成、计时器等）
- 类型安全（TypeScript + Zod）和强大的错误处理
- 零配置 stdio 传输，适合本地 AI 助手
适用场景
- 个人任务管理
- 团队协作中的任务分配和跟踪
- 时间管理和工作效率提升
工具列表
| 工具名称 | 描述 | 参数 | 是否幂等 | 是否破坏性 |
|---|---|---|---|---|
reclaim_list_tasks |
列出任务（默认活跃任务） | { "filter"?: "active"\|"all" } |
✅ | ❌ |
reclaim_get_task |
获取单个任务 | { "taskId": number } |
✅ | ❌ |
reclaim_create_task |
创建新任务 | { /* task properties */ } |
❌ | ❌ |
reclaim_update_task |
更新任务属性 | { "taskId": number, /* updated properties */ } |
✅ | ❌ |
reclaim_mark_complete |
标记任务完成 | { "taskId": number } |
✅ | ❌ |
reclaim_mark_incomplete |
取消归档/标记未完成 | { "taskId": number } |
✅ | ❌ |
reclaim_delete_task |
永久删除任务 | { "taskId": number } |
✅ | ✅ |
reclaim_add_time |
添加计划时间 | { "taskId": number, "minutes": number } |
❌ | ❌ |
reclaim_start_timer |
启动计时器 | { "taskId": number } |
✅ | ❌ |
reclaim_stop_timer |
停止计时器 | { "taskId": number } |
✅ | ❌ |
reclaim_log_work |
记录工作时间 | { "taskId": number, "minutes": number, "end"?: string } |
❌ | ❌ |
reclaim_clear_exceptions |
清除调度异常 | { "taskId": number } |
✅ | ❌ |
reclaim_prioritize |
在计划器中优先处理 | { "taskId": number } |
✅ | ❌ |
常见问题解答
COMPLETE≠ done: Reclaim 在计划块结束时将任务标记为COMPLETE，即使工作尚未完成。此服务器在 LLM 使用工具拉取活动任务时包括这些任务（并提醒模型COMPLETE任务仍然活跃）。然而，LLM（如 Claude）有时在被要求提供"开放"或"活跃"任务时会忽略COMPLETE任务。如果发生这种情况，可能需要明确提示 LLM "包括状态为 COMPLETE 的任务"。
使用教程
使用依赖
- Node.js ≥ 18
- Reclaim API key（从 https://app.reclaim.ai/settings/developer 获取）
安装教程
- 快速启动
-
配置 Claude Desktop（最小配置）
json { "mcpServers": { "reclaim": { "command": "npx", "args": [ "reclaim-mcp-server" ], "env": { "RECLAIM_API_KEY": "xxx" } } } } -
替代配置
json { "mcpServers": { "reclaim": { "command": "absolute/path/to/node (run `which node` in terminal)", "args": [ "/absolute/path/to/reclaim-mcp-server/dist/index.js" ], "env": { "RECLAIM_API_KEY": "xxx" } } } } -
手动安装 ```bash git clone https://github.com/jj3ny/reclaim-mcp-server.git cd reclaim-mcp-server pnpm install && pnpm build
# 使用 API 密钥运行 RECLAIM_API_KEY=your_api_key node dist/index.js ```
调试方式
- 确保 Node.js 版本 ≥ 18
- 确保 RECLAIM_API_KEY 环境变量已正确设置
- 运行
node dist/index.js并检查输出是否有错误