reclaim-mcp-server

The Reclaim.ai MCP Server is an unofficial, community-driven project that allows any MCP-capable client to interact with the Reclaim.ai API. It provides a standardized set of resources and tools, enabling seamless integration with various applications like Claude Desktop, Continue, and custom scripts. The server is designed to be type-safe, using TypeScript and Zod for robust error handling, and offers zero-configuration stdio transport, making it ideal for local AI assistants. By running this server, users can enhance their MCP-aware applications with Reclaim's capabilities, such as task management and scheduling.

Features

• Active-tasks resource (tasks://active)
• 14 task-operation tools (list, create, update, complete, timers, etc.)
• Type-safe (TypeScript + Zod) & solid error-handling
• Zero-config stdio transport – perfect for local AI assistants

MCP Tools

• {'reclaim_list_tasks': 'List tasks (default = active)'}
• {'reclaim_get_task': 'Fetch a task'}
• {'reclaim_create_task': 'Create a new task'}
• {'reclaim_update_task': 'Update task properties'}
• {'reclaim_mark_complete': 'Mark complete'}
• {'reclaim_mark_incomplete': 'Unarchive / mark incomplete'}
• {'reclaim_delete_task': 'Delete permanently'}
• {'reclaim_add_time': 'Add schedule minutes'}
• {'reclaim_start_timer': 'Start timer'}
• {'reclaim_stop_timer': 'Stop timer'}
• {'reclaim_log_work': 'Log work time'}
• {'reclaim_clear_exceptions': 'Clear scheduling exceptions'}
• {'reclaim_prioritize': 'Prioritize in planner'}

Usage with Different Platforms

Claude Desktop configuration

{
  "mcpServers": {
    "reclaim": {
      "command": "npx",
      "args": [
        "reclaim-mcp-server"
      ],
      "env": { "RECLAIM_API_KEY": "xxx" }
    }
  }
}

Alternative Configuration

{
  "mcpServers": {
    "reclaim": {
      "command": "absolute/path/to/node (run `which node` in terminal)",
      "args": [
        "/absolute/path/to/reclaim-mcp-server/dist/index.js"
      ],
      "env": { "RECLAIM_API_KEY": "xxx" }
    }
  }
}

Manual Installation

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

# Run with your API key
RECLAIM_API_KEY=your_api_key node dist/index.js