Skip to main content

Reclaim.ai MCP Server (UNOFFICIAL)

PyPI Downloads Python License: MIT

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

Metadata

Release files for reclaim-mcp-server 0.11.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reclaim-mcp-server 0.11.0
File Size Uploaded
reclaim_mcp_server-0.11.0.tar.gz 27.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for reclaim-mcp-server 0.11.0
File Interpreter ABI Platform
reclaim_mcp_server-0.11.0-py3-none-any.whl Python 3 none any Details

Total release size: 62.2 kB

Release files / reclaim_mcp_server-0.11.0.tar.gz

Download URL reclaim_mcp_server-0.11.0.tar.gz
Size 27.1 kB
Tags Source
SHA-256 checksum
How to use checksums
0f69aa2cd9d6914f25694e9d7985b3fb3be5c07f79c6c469e7d79a932bb3163e
BLAKE2b-256 checksum
How to use checksums
81fb7fb7cf5e35ddfa5f17e004b947fbfb1bd631caef0448ff5c0c216d9b6e5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.12.12

Release files / reclaim_mcp_server-0.11.0-py3-none-any.whl

Download URL reclaim_mcp_server-0.11.0-py3-none-any.whl
Size 35.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b1902cc98cccc2f84fbc345f78d6d7d0dbb4abdee7b6838c4806ce7d3830dec1
BLAKE2b-256 checksum
How to use checksums
fd0ae5678ce1192ba423a87c8da59ddc512c9c3676b2974f2cfb783485a24e34
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.2.0 CPython/3.12.12

Release history Release notifications | RSS feed

This release

0.11.0 This release

2 release files

0.10.0

2 release files

0.9.4

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.1

2 release files

0.8.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page