Clockify MCP Server

Clockify MCP サーバー

この MCP サーバーを使用すると、LLM（Cursor や Claude など）が Clockify ワークスペースを操作できるようになり、高度な時間追跡の自動化とレポート作成が可能になります。このサーバーでは、次のことができます。

• ワークスペース内のすべてのプロジェクトを一覧表示する
• ワークスペース内のすべてのユーザーを一覧表示する
• 自分自身または任意のユーザーの時間エントリーを追加、検索する（権限がある場合）
• すべてのプロジェクトにわたる任意のユーザーのタイムシートを取得する
• Clockify のサマリーレポート API を使用して、ユーザーとプロジェクトごとの時間を月別または任意の日付範囲で集計する
• LLM と連携して、時間追跡データの自動化、要約、分析を行う

機能

• listProjects: 認証済みユーザーのすべてのプロジェクトを一覧表示する
• getTimeEntries: 認証済みユーザーの時間エントリーを一覧表示する（日付による絞り込みは任意）
• addTimeEntry: プロジェクトに時間エントリーを追加する
• listUsers: ワークスペース内のすべてのユーザーを一覧表示する
• getUserTimeEntries: 任意のユーザーの時間エントリーを一覧表示する（日付による絞り込みは任意）
• getSummaryReport: 日付範囲内のユーザー／プロジェクトごとの時間のサマリーレポートを取得する（userIds／projectIdsによる絞り込みは任意）。任意のユーザーまたはプロジェクトの月別／時間別の集計を行えます。

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

Cursor／Claude の MCP サーバー設定

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. プロフィールアイコン（右上）をクリックし、Profile を選択します。
3. API セクションまでスクロールします。
4. API キーをまだ持っていない場合は Generate をクリックするか、既存のキーをコピーします。

貢献と 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 プロフィールまたはリポジトリの「Packages」セクションで確認できます。

メモリバンクと最適化

開発には最適化されたルールとともに cursor を使用しています。詳細はこちらをご覧ください：https://github.com/Bhartendu-Kumar/rules_template

ライセンス

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