Reclaim.ai MCP Server 🚀

Reclaim.ai MCP サーバー 🚀 (非公式)

⚠️ 非公式・無関係のプロジェクトです – このプロジェクトは Reclaim.ai の承認、後援、サポートを受けていません。Reclaim の公開 API を使用しているだけです。ご自身の責任で使用し、Reclaim の利用規約を遵守してください。

公式の代替手段： Reclaim.ai は公式のリモート MCP サーバーを https://mcp.reclaim.ai で提供しています。このコミュニティサーバーよりも、ファーストパーティの連携をお選びいただくほうがよい場合があります。Reclaim のセットアップ手順と #3をご覧ください。

コミュニティが保守するModel Context Protocol（MCP）サーバーです。MCP 対応のあらゆるクライアント（Claude Desktop、Continue、Cursor、カスタムスクリプトなど）から、標準のリソースとツールを通じて Reclaim.ai API を利用できます。

---

🧐 なぜ MCP なのか？

• MCP は LLM 連携における「USB-C」です。1 本の接続で、あらゆるモデルがあらゆるツールとやり取りできます。

• このサーバーを一度実行するだけで、MCP 対応アプリすべてに Reclaim の強力な機能がすぐに加わります。

---

✨ 主な機能

• アクティブなタスクのリソース（tasks://active）

• 13 個のタスク操作ツール（一覧表示、作成、更新、完了、タイマーなど）

• 🛡 型安全（TypeScript + Zod）で、堅牢なエラー処理を備えています

• 📦 設定不要の stdio トランスポート。ローカルの AI アシスタントに最適です

---

📚 MCP の機能

ツール（アクション）

ツール	説明	パラメーター	✅ 冪等	☠️ 破壊的
reclaim_list_tasks	タスクを一覧表示（既定値＝アクティブ）	{ "filter"?: "active"|"all" }	✅	❌
reclaim_get_task	タスクを取得	{ "taskId": number }	✅	❌
reclaim_create_task	新しいタスクを作成	{ /* task properties */ }	❌	❌
reclaim_update_task	タスクのプロパティを更新	{ "taskId": number, /* updated properties */ }	✅	❌
reclaim_mark_complete	完了としてマーク	{ "taskId": number }	✅	❌
reclaim_mark_incomplete	アーカイブを解除／未完了としてマーク	{ "taskId": number }	✅	❌
reclaim_delete_task	完全に削除	{ "taskId": number }	✅	✅
reclaim_add_time	スケジュールに分数を追加	{ "taskId": number, "minutes": number }	❌	❌
reclaim_start_timer	タイマーを開始	{ "taskId": number }	✅	❌
reclaim_stop_timer	タイマーを停止	{ "taskId": number }	✅	❌
reclaim_log_work	作業時間を記録	{ "taskId": number, "minutes": number, "end"?: string }	❌	❌
reclaim_clear_exceptions	スケジュールの例外をクリア	{ "taskId": number }	✅	❌
reclaim_prioritize	プランナーで優先度を設定	{ "taskId": number }	✅	❌

---

⚠️ 既知の問題

COMPLETE ≠ 完了です。 Reclaim は、作業が終わっていなくても、スケジュールされたブロック が終了するとタスクを COMPLETE としてマークします。このサーバーは、LLM がツールを使ってアクティブなタスクを取得する際、これらのタスクをアクティブなものとして扱います（また、COMPLETE のタスクも引き続きアクティブであることをモデルに伝えます）。ただし、LLM（Claude）は「未完了」または「アクティブ」なタスクを尋ねられたとき、COMPLETE のタスクを無視することがあります。その場合は、「ステータスが COMPLETE のタスクも含めてください」と LLM に明示的に指示する必要があるかもしれません。

🚀 クイックスタート

1. 前提条件

   • Node.js ≥ 18
   • Reclaim API キー

2. Claude Desktop の設定（最小構成）

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

代替設定：

{
  "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" }
    }
  }
}

代替方法：手動インストール

ソースからのインストールを希望する場合：

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

🤝 コントリビュート

バグ報告や PR を歓迎します！コントリビュートするには：

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更を加えます（コードスタイルに従ってください）
4. Conventional Commits の形式（feat:、fix: など）でコミットします
5. ブランチにプッシュします（git push origin feature/amazing-feature）
6. プルリクエストを作成します

PR を作成する前に、コミットをスカッシュしてください。

📄 ライセンス

MIT – LICENSE を参照してください。