Reclaim Mcp Server

io.github.universalamateurPublished by GitHub account universalamateurv0.9.1Updated Oct 24, 2026

MCP server for Reclaim.ai - calendar, tasks, habits, and focus time management

VerifiedSTDIODesktop onlyProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Unofficial local MCP server that lets an AI assistant manage Reclaim.ai tasks, calendar events, habits, focus time and productivity analytics.

What you can do
Create, update and manage tasks, including due dates and durations, and query the calendar for upcoming events and availability. Track habits and mark them done. Start and manage focus time blocks. Review productivity and scheduling analytics. Expose a reduced tool set through a configurable tool profile.
When to use it
Useful if you already schedule work through Reclaim.ai and want an assistant to create tasks, check the calendar, log habits or start focus blocks without switching apps.
Requirements
Runs locally as a Python package (pip or uvx, also Docker or from source). Requires a Reclaim.ai account and a Reclaim API key supplied through the RECLAIM_API_KEY environment variable. Network access to the Reclaim.ai public API. Optional RECLAIM_TOOL_PROFILE variable limits exposed tools.
Before you install
Unofficial and not affiliated with Reclaim.ai; it uses their public API at your own risk. It needs a Reclaim API key, which is a credential. Tools can create, change and complete tasks, habits and calendar blocks, so assistant actions affect your real schedule. Rate limiting may occur.

Installation

In SourceWeft

  1. Open Reclaim Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

text
"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

bash
pip install reclaim-mcp-server

3. Configure Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

json
   {     "mcpServers": {       "reclaim": {         "command": "uvx",         "args": ["reclaim-mcp-server"],         "env": { "RECLAIM_API_KEY": "your_key_here" }       }     }   }

4. Restart Claude Desktop

Installation Options

MethodCommand
uvx (recommended)uvx reclaim-mcp-server
pippip install reclaim-mcp-server
Smitherynpx -y @smithery/cli install universalamateur/reclaim-mcp-server --client claude
Dockerdocker pull universalamateur/reclaim-mcp-server
Sourcegit 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:

ProfileToolsUse Case
minimal20Basic task/habit management
standard32Daily productivity
full40All features (default)
json
{  "mcpServers": {    "reclaim": {      "command": "uvx",      "args": ["reclaim-mcp-server"],      "env": {        "RECLAIM_API_KEY": "your_key_here",        "RECLAIM_TOOL_PROFILE": "standard"      }    }  }}

Other Configurations

Docker
json
{  "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)
json
{  "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:

json
{  "command": "uvx",  "args": ["reclaim-mcp-server"],  "env": { "RECLAIM_API_KEY": "your_key_here" }}

Troubleshooting

IssueSolution
"Invalid API key"Verify key at https://app.reclaim.ai/settings/developer
Rate limited (429)Server handles retries automatically; reduce request frequency
Tools not showingRestart Claude Desktop after config change
Docker ARM64 warningUse v0.8.1+ for native Apple Silicon support

Development

bash
poetry installpoetry run pytest                    # Run testspoetry run black src tests           # Formatpoetry run mypy src                  # Type checkpoetry run fastmcp dev src/reclaim_mcp/server.py  # Dev mode

Links

License

MIT – Falko Sieverding (@UniversalAmateur)

Built with FastMCP · Not affiliated with Reclaim.ai

Source: README.md at commit 73e19fe

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.9.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts