# universalamateur/reclaim-mcp-server [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/universalamateur/reclaim-mcp-server  
**GitHub Stars:** 4  
**npm Downloads (last month):** 266  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/universalamateur-reclaim-mcp-server

## Description
Reclaim.ai calendar integration with 40 tools for tasks, habits, focus time, scheduling links, and productivity analytics.

## Tools
Capabilities this server exposes over MCP:

- **health_check** — Check if the server is running.
- **verify_connection** — Verify API connection by fetching current user info.

Returns:
    Connection status with user details (id, email, name).
- **list_tasks** — List active tasks from Reclaim.ai (excludes completed by default).
- **list_completed_tasks** — List completed and archived tasks from Reclaim.ai.
- **get_task** — Get a single task by ID.
- **create_task** — Create a new task in Reclaim.ai for auto-scheduling.
- **update_task** — Update an existing task in Reclaim.ai.
- **mark_task_complete** — Mark a task as complete.
- **delete_task** — Delete a task from Reclaim.ai.
- **add_time_to_task** — Log time spent on a task using Reclaim's planner API.
- **start_task** — Start working on a task (marks as IN_PROGRESS and starts timer).
- **stop_task** — Stop working on a task (pauses timer, keeps task active).
- **prioritize_task** — Prioritize a task (elevates to high priority, triggers rescheduling).
- **restart_task** — Restart a completed/archived task (returns it to active scheduling).
- **snooze_task** — Snooze a task for a preset duration.
- **clear_task_snooze** — Clear a snooze on a task, making it immediately schedulable again.
- **unarchive_task** — Restore an archived task back to active scheduling.
- **extend_task_duration** — Add more scheduled time to a task (extends capacity, doesn't log work).
- **plan_work** — Schedule task work at a specific date/time.
- **get_current_moment** — Get what the user is currently doing right now.

Returns:
    Current moment with active event, task, or free time info.
- **get_next_moment** — Get what's coming up next on the user's schedule.

Returns:
    Next upcoming event, task, or transition info.
- **get_working_hours** — Get all working hours / availability schemes for the user.

Returns:
    List of time scheme objects with schedule policies and day-by-day hours.
- **find_available_times** — Find available meeting times for a set of attendees.
- **list_events** — List calendar events within a time range.
- **list_personal_events** — List Reclaim-managed personal events (tasks, habits, focus time).
- **get_event** — Get a single event by calendar ID and event ID.

Note: Works best with events from list_events (external calendar events).
Reclaim-managed events from list_personal_events may return 404.
- **set_event_rsvp** — Set RSVP status for a calendar event.
- **move_event** — Move/reschedule an event to a new time.
- **list_habits** — List all smart habits from Reclaim.ai.

Returns:
    List of habit objects with lineageId, title, enabled, recurrence, etc.
- **get_habit** — Get a single smart habit by lineage ID.
- **create_habit** — Create a new smart habit for auto-scheduling.
- **update_habit** — Update an existing smart habit.
- **delete_habit** — Delete a smart habit.
- **mark_habit_done** — Mark a habit instance as done.

Use this to mark today's scheduled habit event as completed.
- **skip_habit** — Skip a habit instance.

Use this to skip today's scheduled habit event without marking it done.
- **lock_habit_instance** — Lock a habit instance to prevent it from being rescheduled.
- **unlock_habit_instance** — Unlock a habit instance to allow it to be rescheduled.
- **start_habit** — Start a habit session now.
- **stop_habit** — Stop a currently running habit session.
- **enable_habit** — Enable a disabled habit to resume scheduling.
- **disable_habit** — Disable a habit to pause scheduling without deleting it.
- **convert_event_to_habit** — Convert a calendar event into a recurring smart habit.

Note: Not all events can be converted. The API rejects recurring instances,
all-day events, and multi-day events. Use with short, timed, standalone events.
- **get_user_analytics** — Get personal productivity analytics for the current user.
- **get_focus_insights** — Get focus time insights and recommendations.
- **get_focus_settings** — Get current focus time settings for the user.

Returns:
    List of focus settings objects (one per focus type).
- **update_focus_settings** — Update focus time settings.
- **lock_focus_block** — Lock a focus time block to prevent it from being rescheduled.
- **unlock_focus_block** — Unlock a focus time block to allow it to be rescheduled.
- **reschedule_focus_block** — Reschedule a focus time block to a different time.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

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

**Requires environment variables:** `RECLAIM_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/universalamateur-reclaim-mcp-server/readme_