{
  "markdown": "# Reclaim.ai MCP Server _(UNOFFICIAL)_\n\n<!-- mcp-name: io.github.universalamateur/reclaim-mcp-server -->\n\n[![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)\n\n> **UNOFFICIAL** – Not affiliated with Reclaim.ai. Uses their public API , use at your own risk.\n\nControl your [Reclaim.ai](https://reclaim.ai) calendar, tasks, and habits from AI assistants via [MCP](https://modelcontextprotocol.io).\n\n## What You Can Do\n\n```text\n\"Create a 2-hour task to review the Q1 budget, due Friday\"\n\"What's on my calendar tomorrow?\"\n\"Mark my morning workout habit as done\"\n\"Show me my productivity stats for last week\"\n\"Start a focus block for the next 90 minutes\"\n```\n\n**40 tools** across tasks, calendar, habits, focus time, and analytics. See [docs/TOOLS.md](docs/TOOLS.md) for complete reference.\n\n## Quick Start\n\n### 1. Get your API key: <https://app.reclaim.ai/settings/developer>\n\n### 2. Install\n\n```bash\npip install reclaim-mcp-server\n```\n\n### 3. Configure Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`)\n\n```json\n   {\n     \"mcpServers\": {\n       \"reclaim\": {\n         \"command\": \"uvx\",\n         \"args\": [\"reclaim-mcp-server\"],\n         \"env\": { \"RECLAIM_API_KEY\": \"your_key_here\" }\n       }\n     }\n   }\n```\n\n### 4. Restart Claude Desktop\n\n## Installation Options\n\n| Method | Command |\n|--------|---------|\n| **uvx** (recommended) | `uvx reclaim-mcp-server` |\n| **pip** | `pip install reclaim-mcp-server` |\n| **Smithery** | `npx -y @smithery/cli install universalamateur/reclaim-mcp-server --client claude` |\n| **Docker** | `docker pull universalamateur/reclaim-mcp-server` |\n| **Source** | `git clone https://gitlab.com/universalamateur1/reclaim-mcp-server.git && cd reclaim-mcp-server && poetry install` |\n\n**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)\n\n## Tool Profiles\n\nLimit exposed tools via `RECLAIM_TOOL_PROFILE`:\n\n| Profile | Tools | Use Case |\n|---------|-------|----------|\n| `minimal` | 20 | Basic task/habit management |\n| `standard` | 32 | Daily productivity |\n| `full` | 40 | All features (default) |\n\n```json\n{\n  \"mcpServers\": {\n    \"reclaim\": {\n      \"command\": \"uvx\",\n      \"args\": [\"reclaim-mcp-server\"],\n      \"env\": {\n        \"RECLAIM_API_KEY\": \"your_key_here\",\n        \"RECLAIM_TOOL_PROFILE\": \"standard\"\n      }\n    }\n  }\n}\n```\n\n## Other Configurations\n\n<details>\n<summary>Docker</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"reclaim\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"RECLAIM_API_KEY\", \"universalamateur/reclaim-mcp-server\"],\n      \"env\": { \"RECLAIM_API_KEY\": \"your_key_here\" }\n    }\n  }\n}\n```\n\n</details>\n\n<details>\n<summary>Poetry (from source)</summary>\n\n```json\n{\n  \"mcpServers\": {\n    \"reclaim\": {\n      \"command\": \"/opt/homebrew/bin/poetry\",\n      \"args\": [\"--directory\", \"/path/to/reclaim-mcp-server\", \"run\", \"reclaim-mcp-server\"],\n      \"env\": { \"RECLAIM_API_KEY\": \"your_key_here\" }\n    }\n  }\n}\n```\n\n**Note**: Use `--directory` flag instead of `cwd` – Claude Desktop doesn't respect `cwd`.\n\n</details>\n\n<details>\n<summary>Other MCP clients (Cursor, Continue, Zed, etc.)</summary>\n\nWorks with any MCP-compatible client. Generic stdio config:\n\n```json\n{\n  \"command\": \"uvx\",\n  \"args\": [\"reclaim-mcp-server\"],\n  \"env\": { \"RECLAIM_API_KEY\": \"your_key_here\" }\n}\n```\n\n</details>\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| \"Invalid API key\" | Verify key at <https://app.reclaim.ai/settings/developer> |\n| Rate limited (429) | Server handles retries automatically; reduce request frequency |\n| Tools not showing | Restart Claude Desktop after config change |\n| Docker ARM64 warning | Use v0.8.1+ for native Apple Silicon support |\n\n## Development\n\n```bash\npoetry install\npoetry run pytest                    # Run tests\npoetry run black src tests           # Format\npoetry run mypy src                  # Type check\npoetry run fastmcp dev src/reclaim_mcp/server.py  # Dev mode\n```\n\n## Links\n\n- [Changelog](CHANGELOG.md)\n- [Tool Reference](docs/TOOLS.md)\n- [Contributing](CONTRIBUTING.md)\n- [Report Issue](https://gitlab.com/universalamateur1/reclaim-mcp-server/-/issues/new)\n\n## License\n\n[MIT](LICENSE) – Falko Sieverding ([@UniversalAmateur](https://gitlab.com/UniversalAmateur))\n\n---\n\n<sub>Built with [FastMCP](https://gofastmcp.com) · Not affiliated with [Reclaim.ai](https://reclaim.ai)</sub>\n",
  "bytes": 5007,
  "sha": "ed298087e1ef87649e2523c45353cf1caaf442b29b769e3a9516f748c222e3c0",
  "repo_slug": "universalamateur/reclaim-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_universalamateur_reclaim_mcp_s_caf5d24f/readme"
}