Clockify MCP サーバー

このMCPサーバーは、LLM（CursorやClaudeなど）とClockifyワークスペースとの連携を可能にし、高度な時間追跡の自動化とレポート作成を可能にします。このサーバーでは、以下のことが可能になります。

• ワークスペース内のすべてのプロジェクトを一覧表示する

• ワークスペース内のすべてのユーザーを一覧表示する

• 自分自身または任意のユーザーの時間エントリを追加および検索します（権限がある場合）

• すべてのプロジェクトの任意のユーザーのタイムシートを取得する

• Clockify サマリー レポート API を使用して、ユーザーおよびプロジェクト別に月別またはカスタム日付範囲の内訳の時間を生成

• LLM と統合して、時間追跡データを自動化、要約、分析します。

特徴

• **listProjects:**認証されたユーザーのすべてのプロジェクトを一覧表示します

• **getTimeEntries:**認証されたユーザーの時間エントリを一覧表示します（オプションの日付フィルター付き）

• **addTimeEntry:**プロジェクトに時間エントリを追加する

• **listUsers:**ワークスペース内のすべてのユーザーを一覧表示します

• **getUserTimeEntries:**任意のユーザーの時間エントリを一覧表示します（オプションの日付フィルター付き）

• **getSummaryReport:**指定した日付範囲におけるユーザー／プロジェクト別の時間の概要レポートを取得します（オプションでユーザーID／プロジェクトIDでフィルタリング可能）。任意のユーザーまたはプロジェクトについて、月別／時間別の内訳を表示できます。

Related MCP server: @lewinnovation/clockify-mcp-server

クイックスタート（Docker — 推奨）

カーソル/クロードのMCPサーバー構成

Cursor または Claude のsettings.jsonに以下を追加します ( YOUR_API_KEYを置き換えます)。

{
  "mcpServers": {
    "clockify-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CLOCKIFY_API_KEY=<YOUR_API_KEY>",
        "ghcr.io/inakianduaga/clockify-mcp:latest"  
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Clockify APIキーの取得方法

1. Clockify アカウントにログインします。

2. プロフィールアイコン (右上) をクリックし、 **[プロフィール]**を選択します。

3. APIセクションまで下にスクロールします。

4. API キーがない場合は**「生成」**をクリックするか、既存のキーをコピーします。

貢献とCI/CD

このプロジェクトでは、GitHub Actions を使用して、 mainへのプッシュごとに Docker イメージを自動的にビルドして GitHub Container Registry (GHCR) に公開します。

• 画像URL: ghcr.io/inakianduaga/clockify-mcp:latest

• イメージをプルする方法:

  docker pull ghcr.io/inakianduaga/clockify-mcp:latest

公開されたイメージは、GitHub プロファイルまたはリポジトリの「パッケージ」セクションで表示できます。

メモリバンクと最適化

開発はカーソルと最適化されたルールを組み合わせて行いました。詳細はhttps://github.com/Bhartendu-Kumar/rules\_templateをご覧ください。

ライセンス

このプロジェクトはMITライセンスの下で提供されています。詳細はLICENSEファイルをご覧ください。