Reclaim MCP Server

What universalamateur/reclaim-mcp-server MCP server does

The universalamateur/reclaim-mcp-server MCP server gives AI assistants access to Reclaim.ai calendars, tasks, habits, and scheduling functions. It is an unofficial integration and is not affiliated with Reclaim.ai. The project communicates with Reclaim.ai through the service's public API, so it is intended for users who already have access to a Reclaim account and developer API key.

The README describes 40 tools covering task management, calendar operations, habits, focus time, and productivity-related functions. The documented tool set includes connection checks, task CRUD operations, work timers, task prioritization, snoozing, archiving, planning, event queries, RSVP updates, event moves, availability searches, and habit retrieval.

How it works

The server runs locally as a Python package and communicates with an MCP client over standard input and output. Claude Desktop configuration starts it with uvx reclaim-mcp-server and passes the Reclaim credential through the RECLAIM_API_KEY environment variable. Other MCP-compatible clients can use the same generic stdio arrangement; the README specifically mentions Cursor and other clients.

When an assistant calls a tool, the server sends the corresponding request to Reclaim.ai. verify_connection checks the API connection and returns user details such as ID, email, and name. Scheduling tools can inspect working hours, locate available meeting times, plan work, and report the current or next calendar moment. Task actions can create work for automatic scheduling, update task state, record time, and change scheduling-related properties.

Setup and configuration

Install the package from PyPI with pip install reclaim-mcp-server, or run it directly with uvx reclaim-mcp-server. Create an API key from Reclaim's developer settings, then provide it to the MCP client as RECLAIM_API_KEY.

The server supports three tool profiles through RECLAIM_TOOL_PROFILE:

• minimal exposes 20 tools for basic task and habit management.
• standard exposes 32 tools for daily productivity workflows.
• full exposes all 40 tools and is the default.

A Docker configuration is also documented, using the universalamateur/reclaim-mcp-server image and passing the API key into the container. After changing an MCP client configuration, restart the client so the tools are loaded.

Tools and capabilities

The universalamateur/reclaim-mcp-server MCP server supports these documented operations:

• Check server health and verify the Reclaim connection.
• List active, completed, or archived tasks; retrieve individual tasks; and create, update, complete, restart, or delete tasks.
• Start and stop task timers, add logged time, prioritize tasks, snooze tasks, clear snoozes, unarchive tasks, extend task capacity, and plan work for a specific time.
• Read the user's current moment, next scheduled moment, working-hour schemes, calendar events, and Reclaim-managed personal events.
• Find meeting availability, set event RSVP status, and move calendar events.
• List habits and retrieve an individual habit by lineage ID.

Limitations and notes

This project is explicitly unofficial, and the README advises using Reclaim's public API at the user's own risk. An invalid API key prevents connection, while excessive requests can produce HTTP 429 responses; the server is documented as handling retries, but callers should still avoid unnecessary request frequency.

get_event works best with events returned by list_events. Reclaim-managed entries returned by list_personal_events may instead produce a 404. Tool availability can also vary when a reduced profile is selected. The supplied material does not document a separate paid plan or guarantee support for every MCP client, although it states that the stdio configuration works with MCP-compatible clients.