Summary
Hooks into Reclaim.ai's calendar optimization API with 40 tools spanning tasks, habits, focus time blocks, and analytics. You can spin up tasks with deadlines, check what's scheduled, mark habits complete, or pull productivity stats, all through natural language in Claude. Ships with three tool profiles (minimal, standard, full) if you want to limit surface area. The developer built this as an unofficial integration, so you're working directly against Reclaim's public API. Useful if you're already using Reclaim to auto-schedule your day and want to manipulate it without context switching. Available via uvx, pip, Docker, or from source with Poetry.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Reclaim.ai MCP Server (UNOFFICIAL)
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
"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
pip install reclaim-mcp-server
3. Configure 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. Restart Claude Desktop
Installation Options
| Method | Command |
|---|---|
| uvx (recommended) | uvx reclaim-mcp-server |
| pip | pip install reclaim-mcp-server |
| Smithery | npx -y @smithery/cli install universalamateur/reclaim-mcp-server --client claude |
| Docker | docker pull universalamateur/reclaim-mcp-server |
| Source | git 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:
| Profile | Tools | Use Case |
|---|---|---|
minimal | 20 | Basic task/habit management |
standard | 32 | Daily productivity |
full | 40 | All features (default) |
{
"mcpServers": {
"reclaim": {
"command": "uvx",
"args": ["reclaim-mcp-server"],
"env": {
"RECLAIM_API_KEY": "your_key_here",
"RECLAIM_TOOL_PROFILE": "standard"
}
}
}
}
Other Configurations
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 (from source)
{
"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:
{
"command": "uvx",
"args": ["reclaim-mcp-server"],
"env": { "RECLAIM_API_KEY": "your_key_here" }
}
Troubleshooting
| Issue | Solution |
|---|---|
| "Invalid API key" | Verify key at https://app.reclaim.ai/settings/developer |
| Rate limited (429) | Server handles retries automatically; reduce request frequency |
| Tools not showing | Restart Claude Desktop after config change |
| Docker ARM64 warning | Use v0.8.1+ for native Apple Silicon support |
Development
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
Links
License
MIT – Falko Sieverding (@UniversalAmateur)
Built with FastMCP · Not affiliated with Reclaim.ai
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Categories
Registryactive
Packagereclaim-mcp-server
TransportSTDIO
UpdatedJan 6, 2026
