io.github.universalamateur/reclaim-mcp-server
MCP server for Reclaim.ai - calendar, tasks, habits, and focus time management
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
reclaim-mcp-serverclaude mcp add reclaim-mcp-server -- uvx reclaim-mcp-server==0.9.1
{
"mcpServers": {
"reclaim-mcp-server": {
"command": "uvx",
"args": [
"reclaim-mcp-server==0.9.1"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
Questions fréquentes
Qu'est-ce que io.github.universalamateur/reclaim-mcp-server ?
MCP server for Reclaim.ai - calendar, tasks, habits, and focus time management
Comment installer io.github.universalamateur/reclaim-mcp-server ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add reclaim-mcp-server -- uvx reclaim-mcp-server==0.9.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.universalamateur/reclaim-mcp-server ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.universalamateur/reclaim-mcp-server est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.universalamateur/reclaim-mcp-server ?
Il est publié par universalamateur. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.