reclaim

This MCP server provides a Reclaim.ai integration for MCP-capable clients. It exposes an Active-Tasks resource and a suite of task operations (list, get, create, update, complete, timer controls, and more) via standardized MCP tools. Clients can query tasks, create new ones, adjust details, start/stop timers, log work, and manage scheduling while keeping type-safe contracts and consistent error handling. To use it, point your MCP-enabled client at the server, and reference the available tools (e.g., reclaim_list_tasks, reclaim_get_task, reclaim_create_task, reclaim_update_task, reclaim_mark_complete, reclaim_start_timer, reclaim_stop_timer, reclaim_log_work, reclaim_delete_task, etc.) to perform common task workflows against Reclaim.ai.

Prerequisites:

• Node.js 18+ installed on your machine
• Access to a Reclaim.ai API key

Installation steps:

1. Install dependencies and build (if you are running from source):

git clone https://github.com/jj3ny/reclaim-mcp-server.git
cd reclaim-mcp-server
pnpm install
pnpm build

2. Run the server using your API key (string value for RECLAIM_API_KEY):

RECLAIM_API_KEY=your_api_key node dist/index.js

3. Alternatively, use npx to run directly (no build required if the package is published):

RECLAIM_API_KEY=your_api_key
npx reclaim-mcp-server

Configure your MCP client to point to the running server (see mcp_config in this document).

Notes and tips:

• Ensure your RECLAIM_API_KEY is kept secret; do not commit it to source control.
• The server exposes multiple task-related tools; refer to the capability table in the README for supported parameters.
• If you run via npx, the server module must be published as reclaim-mcp-server on npm. If you clone and run locally, you may need to build first.
• When using timers or log_work, be mindful of time zones and end times; use ISO 8601 strings for end where required.
• If you encounter authentication or API errors from Reclaim, verify your API key permissions and the key has not expired.
• You can run the server behind a process manager (pm2, systemd) for reliability in production.
• You can override the command and provide an absolute node path and dist/index.js as shown in the Quick Start alternative configuration.