Reclaim Mcp Server

io.github.universalamateur由 GitHub 账号 universalamateur 发布v0.9.1更新于 Oct 24, 2026

MCP server for Reclaim.ai - calendar, tasks, habits, and focus time management

已验证STDIO仅桌面效率与工作流沟通与协作

概览

AI 生成的概览

非官方本地 MCP 服务器，让 AI 助手管理 Reclaim.ai 的任务、日历、习惯、专注时间和效率分析。

可以做什么
创建、更新和管理任务，包括截止日期与时长，并查询日历中的日程与空闲时间。跟踪习惯并标记完成。启动和管理专注时间块。查看效率与排程分析数据。可通过工具配置档限制对外暴露的工具数量。
适用场景
适合已用 Reclaim.ai 安排工作、希望助手直接创建任务、查看日历、记录习惯或开启专注时段而无需切换应用的用户。
运行要求
以本地 Python 包运行（pip 或 uvx，也支持 Docker 或源码安装）。需要 Reclaim.ai 账号，并通过环境变量 RECLAIM_API_KEY 提供 API 密钥。需能访问 Reclaim.ai 公共 API。可选环境变量 RECLAIM_TOOL_PROFILE 用于限制工具数量。
安装前请注意
非官方项目，与 Reclaim.ai 无关联，使用其公共 API 需自行承担风险。需要 Reclaim API 密钥这一凭据。工具可创建、修改和完成任务、习惯及日历时间块，助手操作会影响真实日程。可能遇到请求频率限制。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Reclaim Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Reclaim.ai MCP Server (UNOFFICIAL)

[PyPI] [Downloads] [Python] [License: MIT]

UNOFFICIAL – Not affiliated with Reclaim.ai. Uses their public API , use at your own risk.

Control your Reclaim.ai calendar, tasks, and habits from AI assistants via MCP.

What You Can Do

text
"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 tools across tasks, calendar, habits, focus time, and analytics. See docs/TOOLS.md for complete reference.

Quick Start

1. Get your API key: https://app.reclaim.ai/settings/developer

2. Install

bash
pip install reclaim-mcp-server

3. Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

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

4. Restart Claude Desktop

Installation Options

MethodCommand
uvx (recommended)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
Sourcegit clone https://gitlab.com/universalamateur1/reclaim-mcp-server.git && cd reclaim-mcp-server && poetry install

Registries: PyPI · Smithery · Glama · GitHub · GitLab

Tool Profiles

Limit exposed tools via RECLAIM_TOOL_PROFILE:

ProfileToolsUse Case
minimal20Basic task/habit management
standard32Daily productivity
full40All features (default)
json
{  "mcpServers": {    "reclaim": {      "command": "uvx",      "args": ["reclaim-mcp-server"],      "env": {        "RECLAIM_API_KEY": "your_key_here",        "RECLAIM_TOOL_PROFILE": "standard"      }    }  }}

Other Configurations

Docker
json
{  "mcpServers": {    "reclaim": {      "command": "docker",      "args": ["run", "-i", "--rm", "-e", "RECLAIM_API_KEY", "universalamateur/reclaim-mcp-server"],      "env": { "RECLAIM_API_KEY": "your_key_here" }    }  }}
Poetry (from source)
json
{  "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" }    }  }}

Note: Use --directory flag instead of cwd – Claude Desktop doesn't respect cwd.

Other MCP clients (Cursor, Continue, Zed, etc.)

Works with any MCP-compatible client. Generic stdio config:

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

Troubleshooting

IssueSolution
"Invalid API key"Verify key at https://app.reclaim.ai/settings/developer
Rate limited (429)Server handles retries automatically; reduce request frequency
Tools not showingRestart Claude Desktop after config change
Docker ARM64 warningUse v0.8.1+ for native Apple Silicon support

Development

bash
poetry installpoetry run pytest                    # Run testspoetry run black src tests           # Formatpoetry run mypy src                  # Type checkpoetry run fastmcp dev src/reclaim_mcp/server.py  # Dev mode

Links

License

MIT – Falko Sieverding (@UniversalAmateur)

Built with FastMCP · Not affiliated with Reclaim.ai

来源：README.md，提交 73e19fe

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.9.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分