mcpField
R
reclaim-mcp-server

reclaim-mcp-server

本地服务
github.com/universalamateur生产力435 周前更新
代码仓库

关于 reclaim-mcp-server

reclaim-mcp-server 是一个非官方 MCP 服务，可让 AI 助手管理 Reclaim.ai 日历、任务、习惯、专注时间和生产力数据。它提供 40 个工具，并可通过配置档精简开放的工具集。

主要功能

  1. 01管理任务和日历
  2. 02跟踪习惯与专注时间
  3. 03查看生产力分析
  4. 04选择工具配置档

适用场景

  1. 01创建并安排任务
  2. 02查看即将到来的日程
  3. 03将习惯标记为已完成
  4. 04查看每周生产力数据

MCP 相关

它向兼容 MCP 的客户端提供 Reclaim.ai 操作工具，可按配置档开放 20、32 或 40 个工具。连接需要 Reclaim.ai API 密钥；该项目与 Reclaim.ai 无隶属关系。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "universalamateur-reclaim": {
      "command": "uvx",
      "args": [
        "reclaim-mcp-server"
      ]
    }
  }
}
启动命令uvx reclaim-mcp-server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypireclaim-mcp-server0.9.1

工具

40

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Reclaim.ai MCP 服务 （非官方）

PyPI Downloads Python License: MIT

非官方 – 与 Reclaim.ai 无关联。使用其公开 API，风险自负。

通过 MCP，使用 AI 助手管理你的 Reclaim.ai 日历、任务和习惯。

你可以做什么

"Create a 2-hour task to review the Q1 budget, due Friday"
"What's on my calendar tomorrow?"
"Mark my morning workout habit as done"
"Show me my productivity stats for last week"
"Start a focus block for the next 90 minutes"

涵盖任务、日历、习惯、专注时间和分析的 40 个工具。完整参考请参阅 docs/TOOLS.md。

快速开始

1. 获取 API 密钥：https://app.reclaim.ai/settings/developer
2. 安装
pip install reclaim-mcp-server
3. 配置 Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）
   {
     "mcpServers": {
       "reclaim": {
         "command": "uvx",
         "args": ["reclaim-mcp-server"],
         "env": { "RECLAIM_API_KEY": "your_key_here" }
       }
     }
   }
4. 重启 Claude Desktop

安装选项

方法命令
uvx（推荐）uvx reclaim-mcp-server
pippip install reclaim-mcp-server
Smitherynpx -y @smithery/cli install universalamateur/reclaim-mcp-server --client claude
Dockerdocker pull universalamateur/reclaim-mcp-server
源代码git clone https://gitlab.com/universalamateur1/reclaim-mcp-server.git && cd reclaim-mcp-server && poetry install

注册目录： PyPI · Smithery · Glama · GitHub · GitLab

工具配置档

通过 RECLAIM_TOOL_PROFILE 限制公开的工具：

配置档工具使用场景
minimal20基本任务／习惯管理
standard32日常效率管理
full40全部功能（默认）
{
  "mcpServers": {
    "reclaim": {
      "command": "uvx",
      "args": ["reclaim-mcp-server"],
      "env": {
        "RECLAIM_API_KEY": "your_key_here",
        "RECLAIM_TOOL_PROFILE": "standard"
      }
    }
  }
}

其他配置

Docker 
{
  "mcpServers": {
    "reclaim": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RECLAIM_API_KEY", "universalamateur/reclaim-mcp-server"],
      "env": { "RECLAIM_API_KEY": "your_key_here" }
    }
  }
}
Poetry（从源代码安装） 
{
  "mcpServers": {
    "reclaim": {
      "command": "/opt/homebrew/bin/poetry",
      "args": ["--directory", "/path/to/reclaim-mcp-server", "run", "reclaim-mcp-server"],
      "env": { "RECLAIM_API_KEY": "your_key_here" }
    }
  }
}

注意：请使用 --directory 标志代替 cwd —— Claude Desktop 不会遵循 cwd。

其他 MCP 客户端（Cursor、Continue、Zed 等）

可与任何兼容 MCP 的客户端配合使用。通用 stdio 配置：

{
  "command": "uvx",
  "args": ["reclaim-mcp-server"],
  "env": { "RECLAIM_API_KEY": "your_key_here" }
}

故障排除

问题解决方案
“API 密钥无效”在 https://app.reclaim.ai/settings/developer 验证密钥
请求频率受限（429）服务会自动重试；请降低请求频率
未显示工具更改配置后重启 Claude Desktop
Docker ARM64 警告使用 v0.8.1+ 以获得原生 Apple Silicon 支持

开发

poetry install
poetry run pytest                    # Run tests
poetry run black src tests           # Format
poetry run mypy src                  # Type check
poetry run fastmcp dev src/reclaim_mcp/server.py  # Dev mode

链接

许可证

MIT – Falko Sieverding (@UniversalAmateur)

使用 FastMCP 构建 · 与 Reclaim.ai 无关联

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。