1. Conduid
  2. AI
  3. Reclaim MCP Server
MCP server · AI

Reclaim MCP Server

by · github.com/johnjhughes/reclaim-mcp-server

A Model Context Protocol (MCP) server implementation using TypeScript

Unclaimed MIT ai
InstallView source
39Low

Scored 5 days ago · breakdown

About Reclaim MCP Server

Reclaim MCP Server is an MCP server published by johnjhughes in the AI category: a Model Context Protocol (MCP) server implementation using TypeScript.

The repository has 19 stars and 7 forks, with the last commit 19 days ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/johnjhughes/reclaim-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Reclaim MCP Server

Powered by Claude · Grounded in docs

I know everything about Reclaim MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 3 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.

1 check has not been run yet.

Releases

v0.1.2v0.1.2

README

npm version

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.

Official alternative: Reclaim.ai offers an official remote MCP server at https://mcp.reclaim.ai. You may prefer the first-party integration over this community server. See Reclaim's setup instructions and #3.

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)

  • 13 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

  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:

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

🤝 Contributing

Bug reports & PRs welcome! To contribute:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes (following the code style)
  4. Commit using Conventional Commits (feat:, fix:, etc.)
  5. Push to your branch (git push origin feature/amazing-feature)
  6. Open a Pull Request

Please squash your commits before opening a PR.

📄 License

MIT – see LICENSE.

README fetched from the repository 3 days ago. The original is authoritative.

Questions

About Reclaim MCP Server

How do I install Reclaim MCP Server?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Reclaim MCP Server safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 5 of the 5 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Reclaim MCP Server still maintained?

Yes — the last commit was 19 days ago. The repository has 19 stars and 7 forks.