Reclaim.ai MCP Server 🚀
About
Reclaim is an ai calendar management tool that helps you plan your schedule and tasks.
Details
- License
- MIT license
Explore
- Active‑tasks resource (tasks://active)
- 14 task‑operation tools (list, create, update, complete, timers, …)
- 🛡 Type‑safe (TypeScript + Zod) & solid error‑handling
- 📦 Zero‑config stdio transport – perfect for local AI assistants
---
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Reclaim.ai MCP Server 🚀Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Prerequisites
- Node.js ≥ 18
- Reclaim API key
2. Claude Desktop configuration (minimal)
{
"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" }
}
}
}
If you prefer to install from source:
```bash
git clone https://github.com/jj3ny/reclaim-mcp-server.git
cd reclaim-mcp-server
pnpm install && pnpm build
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
Prioritise in planner
| Tool | Description | Parameters | ✅ Idemp. | ☠️ Destr. |
| -------------------------- | ----------------------------- | --------------------------------------------------------- | --------- | --------- |
| reclaim_list_tasks | List tasks (default = active) | { "filter"?: "active"\|"all" } | ✅ | ❌ |
| reclaim_get_task | Fetch a task | { "taskId": number } | ✅ | ❌ |
| reclaim_create_task | Create a new task | { / task properties / } | ❌ | ❌ |
| reclaim_update_task | Update task properties | { "taskId": number, / updated properties / } | ✅ | ❌ |
| reclaim_mark_complete | Mark complete | { "taskId": number } | ✅ | ❌ |
| reclaim_mark_incomplete | Unarchive / mark incomplete | { "taskId": number } | ✅ | ❌ |
| reclaim_delete_task | Delete permanently | { "taskId": number } | ✅ | ✅ |
| reclaim_add_time | Add schedule minutes | { "taskId": number, "minutes": number } | ❌ | ❌ |
| reclaim_start_timer | Start timer | { "taskId": number } | ✅ | ❌ |
| reclaim_stop_timer | Stop timer | { "taskId": number } | ✅ | ❌ |
| reclaim_log_work | Log work time | { "taskId": number, "minutes": number, "end"?: string } | ❌ | ❌ |
| reclaim_clear_exceptions | Clear scheduling exceptions | { "taskId": number } | ✅ | ❌ |
| reclaim_prioritize | Prioritise in planner | { "taskId": number } | ✅ | ❌ |
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"reclaim.ai mcp server \ud83d\ude80": {
"reclaim-mcp-server": {
"command": "node",
"args": [
"dist/index.js"
],
"env": {
"RECLAIM_API_KEY": "your_api_key"
}
}
}
}
}McpServers
{
"reclaim-mcp-server": {
"command": "node",
"args": [
"dist/index.js"
],
"env": {
"RECLAIM_API_KEY": "your_api_key"
}
}
}> ⚠️ UNOFFICIAL & UNAFFILIATED – This project is not endorsed, sponsored, or supported by Reclaim.ai. It simply uses Reclaim's public API. Use at your own risk and comply with Reclaim's Terms of Service.
A community‑maintained Model Context Protocol (MCP) server that lets _any_ MCP‑capable client (Claude Desktop, Continue, Cursor, custom scripts, …) interact with the Reclaim.ai API through a set of standard resources & tools.
---
🧐 Why MCP?
- MCP is the "USB‑C" of LLM integrations – one wire that lets every model talk to every tool.
- Run this server once and _all_ your MCP‑aware apps instantly gain Reclaim super‑powers.
---
✨ Key Features
- Active‑tasks resource (tasks://active)
- 14 task‑operation tools (list, create, update, complete, timers, …)
- 🛡 Type‑safe (TypeScript + Zod) & solid error‑handling
- 📦 Zero‑config stdio transport – perfect for local AI assistants
---
📚 MCP Capabilities
Tools (Actions)
| Tool | Description | Parameters | ✅ Idemp. | ☠️ Destr. |
| -------------------------- | ----------------------------- | --------------------------------------------------------- | --------- | --------- |
| reclaim_list_tasks | List tasks (default = active) | { "filter"?: "active"\|"all" } | ✅ | ❌ |
| reclaim_get_task | Fetch a task | { "taskId": number } | ✅ | ❌ |
| reclaim_create_task | Create a new task | { / task properties / } | ❌ | ❌ |
| reclaim_update_task | Update task properties | { "taskId": number, / updated properties / } | ✅ | ❌ |
| reclaim_mark_complete | Mark complete | { "taskId": number } | ✅ | ❌ |
| reclaim_mark_incomplete | Unarchive / mark incomplete | { "taskId": number } | ✅ | ❌ |
| reclaim_delete_task | Delete permanently | { "taskId": number } | ✅ | ✅ |
| reclaim_add_time | Add schedule minutes | { "taskId": number, "minutes": number } | ❌ | ❌ |
| reclaim_start_timer | Start timer | { "taskId": number } | ✅ | ❌ |
| reclaim_stop_timer | Stop timer | { "taskId": number } | ✅ | ❌ |
| reclaim_log_work | Log work time | { "taskId": number, "minutes": number, "end"?: string } | ❌ | ❌ |
| reclaim_clear_exceptions | Clear scheduling exceptions | { "taskId": number } | ✅ | ❌ |
| reclaim_prioritize | Prioritise in planner | { "taskId": number } | ✅ | ❌ |
---
⚠️ Known Issues
COMPLETE ≠ done. Reclaim marks a task COMPLETE when its _scheduled block_ ends, even if you haven't finished the work. This server does include those tasks as active when the LLM uses the tool to pull active tasks (and reminds the model that COMPLETE tasks are still active). However, LLMs (Claude) sometimes ignore COMPLETE tasks when asked for "open" or "active" tasks. If that happens, you may need to prompt the LLM explicitly to "include tasks with status COMPLETE".
🚀 Quick Start
1. Prerequisites
- Node.js ≥ 18
- Reclaim API key
2. Claude Desktop configuration (minimal)
{
"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" }
}
}
}
Alternative: Manual Installation
If you prefer to install from source:
```bash
git clone https://github.com/jj3ny/reclaim-mcp-server.git
cd reclaim-mcp-server
pnpm install && pnpm build
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
