Skip to main content
Glama

reclaim-mcp

MCP server for Reclaim.ai 1.0: create and manage tasks that Reclaim schedules as named calendar blocks, pick the Hours (and so the calendar) each task lands on, and create, list or toggle habits. It calls only https://api.app.reclaim.ai.

Unofficial: not affiliated with or endorsed by Reclaim.ai. MIT licensed.

Tools

Tool

What it does

list_hours

Hours with their weekly windows and the calendar tasks land on

update_hours

Change one Hours' weekly windows (only the days you pass) and/or the calendar its tasks land on

list_tasks, get_task

Tasks with durations and block sizes in minutes, and whether Reclaim flags them at risk

create_task, update_task

Title, total minutes, min/max block minutes, Hours by name, Work/Personal, due, not-before, priority, notes; startAt books the first block at an exact time

complete_task, delete_task

Mark done, or delete with its blocks

list_blocks

Scheduled task and habit blocks: time, calendar, locked, and the blockId the block tools take

lock_block, unlock_block

Lock a block where it is or at a new start time, or let Reclaim move it again

skip_habit_block, complete_habit_block

Skip one habit occurrence, or mark one done

list_habits, create_habit, update_habit

Weekly habits: block length, days, ideal time, Hours by name, calendar

set_habit_enabled

Turn a habit on or off

Related MCP server: Todoist MCP Server

Local setup (macOS)

Requires Node 24 (runs the TypeScript directly, no build step).

npm install
security add-generic-password -s reclaim-api-key -a "$USER" -w   # paste the key from app.reclaim.ai/settings/developer
claude mcp add -s user reclaim -- "$(which node)" "$PWD/src/stdio.ts"

The server reads RECLAIM_API_KEY from the environment first, then the Keychain item reclaim-api-key. For Claude Desktop, add the same command under mcpServers in ~/Library/Application Support/Claude/claude_desktop_config.json.

Hosted (Vercel, for claude.ai web and mobile)

api/mcp.ts serves the same tools over HTTP. Every request needs Authorization: Bearer <secret>, where the secret is one of the comma-separated values in MCP_SECRETS (one per person, so each can be revoked alone). Production environment variables:

Variable

Value

RECLAIM_API_KEY

Reclaim API key

MCP_SECRETS

Comma-separated connector secrets

In claude.ai, add a custom connector with the URL https://<deployment>/api/mcp and a request header Authorization: Bearer <your secret>. It then appears in the mobile apps too.

Checks

npm test
npm run typecheck

Related MCP Connectors

Related MCP Servers