Reclaim.ai MCP Server (UNOFFICIAL)

1# Reclaim.ai MCP Server _(UNOFFICIAL)_
2 
3<!-- mcp-name: io.github.universalamateur/reclaim-mcp-server -->
4 
5[![PyPI](https://img.shields.io/pypi/v/reclaim-mcp-server)](https://pypi.org/project/reclaim-mcp-server/) [![Downloads](https://img.shields.io/pypi/dm/reclaim-mcp-server)](https://pypi.org/project/reclaim-mcp-server/) [![Python](https://img.shields.io/pypi/pyversions/reclaim-mcp-server)](https://pypi.org/project/reclaim-mcp-server/) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6 
7> **UNOFFICIAL** – Not affiliated with Reclaim.ai. Uses their public API , use at your own risk.
8 
9Control your [Reclaim.ai](https://reclaim.ai) calendar, tasks, and habits from AI assistants via [MCP](https://modelcontextprotocol.io).
10 
11## What You Can Do
12 
13```text
14"Create a 2-hour task to review the Q1 budget, due Friday"
15"What's on my calendar tomorrow?"
16"Mark my morning workout habit as done"
17"Show me my productivity stats for last week"
18"Start a focus block for the next 90 minutes"
19```
20 
21**40 tools** across tasks, calendar, habits, focus time, and analytics. See [docs/TOOLS.md](docs/TOOLS.md) for complete reference.
22 
23## Quick Start
24 
25### 1. Get your API key: <https://app.reclaim.ai/settings/developer>
26 
27### 2. Install
28 
29```bash
30pip install reclaim-mcp-server
31```
32 
33### 3. Configure Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`)
34 
35```json
36   {
37     "mcpServers": {
38       "reclaim": {
39         "command": "uvx",
40         "args": ["reclaim-mcp-server"],
41         "env": { "RECLAIM_API_KEY": "your_key_here" }
42       }
43     }
44   }
45```
46 
47### 4. Restart Claude Desktop
48 
49## Installation Options
50 
51| Method | Command |
52|--------|---------|
53| **uvx** (recommended) | `uvx reclaim-mcp-server` |
54| **pip** | `pip install reclaim-mcp-server` |
55| **Smithery** | `npx -y @smithery/cli install universalamateur/reclaim-mcp-server --client claude` |
56| **Docker** | `docker pull universalamateur/reclaim-mcp-server` |
57| **Source** | `git clone https://gitlab.com/universalamateur1/reclaim-mcp-server.git && cd reclaim-mcp-server && poetry install` |
58 
59**Registries:** [PyPI](https://pypi.org/project/reclaim-mcp-server/) · [Smithery](https://smithery.ai/server/universalamateur/reclaim-mcp-server) · [Glama](https://glama.ai/mcp/servers/@universalamateur/reclaim-mcp-server) · [GitHub](https://github.com/universalamateur/reclaim-mcp-server) · [GitLab](https://gitlab.com/universalamateur1/reclaim-mcp-server)
60 
61## Tool Profiles
62 
63Limit exposed tools via `RECLAIM_TOOL_PROFILE`:
64 
65| Profile | Tools | Use Case |
66|---------|-------|----------|
67| `minimal` | 20 | Basic task/habit management |
68| `standard` | 32 | Daily productivity |
69| `full` | 40 | All features (default) |
70 
71```json
72{
73  "mcpServers": {
74    "reclaim": {
75      "command": "uvx",
76      "args": ["reclaim-mcp-server"],
77      "env": {
78        "RECLAIM_API_KEY": "your_key_here",
79        "RECLAIM_TOOL_PROFILE": "standard"
80      }
81    }
82  }
83}
84```
85 
86## Other Configurations
87 
88<details>
89<summary>Docker</summary>
90 
91```json
92{
93  "mcpServers": {
94    "reclaim": {
95      "command": "docker",
96      "args": ["run", "-i", "--rm", "-e", "RECLAIM_API_KEY", "universalamateur/reclaim-mcp-server"],
97      "env": { "RECLAIM_API_KEY": "your_key_here" }
98    }
99  }
100}
101```
102 
103</details>
104 
105<details>
106<summary>Poetry (from source)</summary>
107 
108```json
109{
110  "mcpServers": {
111    "reclaim": {
112      "command": "/opt/homebrew/bin/poetry",
113      "args": ["--directory", "/path/to/reclaim-mcp-server", "run", "reclaim-mcp-server"],
114      "env": { "RECLAIM_API_KEY": "your_key_here" }
115    }
116  }
117}
118```
119 
120**Note**: Use `--directory` flag instead of `cwd` – Claude Desktop doesn't respect `cwd`.
121 
122</details>
123 
124<details>
125<summary>Other MCP clients (Cursor, Continue, Zed, etc.)</summary>
126 
127Works with any MCP-compatible client. Generic stdio config:
128 
129```json
130{
131  "command": "uvx",
132  "args": ["reclaim-mcp-server"],
133  "env": { "RECLAIM_API_KEY": "your_key_here" }
134}
135```
136 
137</details>
138 
139## Troubleshooting
140 
141| Issue | Solution |
142|-------|----------|
143| "Invalid API key" | Verify key at <https://app.reclaim.ai/settings/developer> |
144| Rate limited (429) | Server handles retries automatically; reduce request frequency |
145| Tools not showing | Restart Claude Desktop after config change |
146| Docker ARM64 warning | Use v0.8.1+ for native Apple Silicon support |
147 
148## Development
149 
150```bash
151poetry install
152poetry run pytest                    # Run tests
153poetry run black src tests           # Format
154poetry run mypy src                  # Type check
155poetry run fastmcp dev src/reclaim_mcp/server.py  # Dev mode
156```
157 
158## Links
159 
160- [Changelog](CHANGELOG.md)
161- [Tool Reference](docs/TOOLS.md)
162- [Contributing](CONTRIBUTING.md)
163- [Report Issue](https://gitlab.com/universalamateur1/reclaim-mcp-server/-/issues/new)
164 
165## License
166 
167[MIT](LICENSE) – Falko Sieverding ([@UniversalAmateur](https://gitlab.com/UniversalAmateur))
168 
169---
170 
171<sub>Built with [FastMCP](https://gofastmcp.com) · Not affiliated with [Reclaim.ai](https://reclaim.ai)</sub>
172