Reclaim.ai MCP Server 🚀
About
Reclaim is an ai calendar management tool that helps you plan your schedule and tasks.
Details
- Author
- jj3ny
- Downloads
- 215
- Categories
- Productivity, Other, AI, Project Management
Jump to
- Active-tasks resource for current tasks
- 14 task-operation tools for full CRUD
- Type-safe with TypeScript and Zod
- Solid error-handling throughout
- Zero-config stdio transport for local use
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
Run the server via npx with a Reclaim API key, or install from source with Node.js ≥18. Configure your MCP client (e.g., Claude Desktop) with the command and environment variable shown in the quick-start configuration.
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"
}
}
}Reclaim.ai MCP Server 🚀 _(UNOFFICIAL)_
> ⚠️ 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.
