reclaim-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@reclaim-mcpCreate a 45-minute task called Draft report in my Work hours"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Hours with their weekly windows and the calendar tasks land on |
| Change one Hours' weekly windows (only the days you pass) and/or the calendar its tasks land on |
| Tasks with durations and block sizes in minutes, and whether Reclaim flags them at risk |
| Title, total minutes, min/max block minutes, Hours by name, Work/Personal, due, not-before, priority, notes; |
| Mark done, or delete with its blocks |
| Scheduled task and habit blocks: time, calendar, locked, and the |
| Lock a block where it is or at a new start time, or let Reclaim move it again |
| Skip one habit occurrence, or mark one done |
| Weekly habits: block length, days, ideal time, Hours by name, calendar |
| 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 |
| 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 typecheckThis server cannot be deployed
Maintenance
Related MCP Connectors
Read tasks, habits, events and scheduling links; create and update Reclaim tasks and habits.
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
- TasksOAuthapp.thetasks
Read and edit your Tasks boards: create and update tasks, comment, and track time.
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables AI assistants to manage tasks in Sunsama, including creating tasks, reading daily and backlog tasks, marking tasks complete, and organizing projects through streams.16136 npm52MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Todoist tasks, projects, sections, and labels through natural language, supporting task creation, updates, completion, and intelligent organization of your workflow.13 npmMIT
- AlicenseAqualityBmaintenanceEnables MCP-compatible clients to manage Reclaim.ai tasks, including listing, creating, updating, completing, deleting, and timer operations through natural language.135 npm19MIT
- AlicenseNot gradedqualityAmaintenanceEnables managing Nextcloud tasks through natural language, including creating, updating, completing, and deleting tasks.29 PyPI2MIT