About io.github.universalamateur/reclaim-mcp-server
io.github.universalamateur/reclaim-mcp-server is an MCP server in the Productivity category: mCP server for Reclaim.ai - calendar, tasks, habits, and focus time management.
Install
uvx reclaim-mcp-serverpip install reclaim-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about io.github.universalamateur/reclaim-mcp-server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
{
"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 mode
Links
License
MIT – Falko Sieverding (@UniversalAmateur)
Built with FastMCP · Not affiliated with Reclaim.ai
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.