This server provides AI assistants with programmatic access to manage Reclaim.ai calendars, tasks, habits, focus time, and analytics through 40+ tools.
Task Management: Create tasks with auto-scheduling, priorities (P1-P4), duration, due dates, and chunk sizes. Track progress with start/stop timers, time logs, and status updates (NEW, SCHEDULED, IN_PROGRESS, COMPLETE, ARCHIVED). List, update, complete, delete, prioritize, and restart tasks.
Calendar & Events: View calendar events and Reclaim-managed personal events (tasks, habits, focus time) within date ranges with filtering options. Get detailed information for specific events.
Smart Habits: Create recurring habits with customizable frequency (daily, weekly, monthly, yearly), ideal times, durations, and defense levels. Manage instances by marking done, skipping, enabling, or disabling habits.
Focus Time Management: View and update focus settings including duration ranges (min/ideal/max) and defense aggression levels. Control individual focus blocks by locking, unlocking, or rescheduling them. Access focus analytics with protected hours, interruptions, and recommendations.
Analytics & Insights: Track productivity metrics with time breakdowns by category and date. Analyze focus time patterns and monitor time allocation across event categories.
System Operations: Verify API connectivity, check server health, and use flexible tool profiles (minimal/standard/full) to customize exposed functionality for different use cases.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@reclaim-mcp-servercreate a 1-hour task to review project proposal, due tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-server3. 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) |
|
pip |
|
Smithery |
|
Docker |
|
Source |
|
Registries: PyPI · Smithery · Glama · GitHub · GitLab
Tool Profiles
Limit exposed tools via RECLAIM_TOOL_PROFILE:
Profile | Tools | Use Case |
| 20 | Basic task/habit management |
| 32 | Daily productivity |
| 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
{
"mcpServers": {
"reclaim": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "RECLAIM_API_KEY", "universalamateur/reclaim-mcp-server"],
"env": { "RECLAIM_API_KEY": "your_key_here" }
}
}
}{
"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.
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 modeLinks
License
MIT – Falko Sieverding (@UniversalAmateur)
Built with FastMCP · Not affiliated with Reclaim.ai
