Clockify Automation
Claude Codeから直接Clockifyのタイムトラッキング操作を自動化します。時間エントリの記録、過去データの照会、ワークスペース管理、チームアクティビティの監査をターミナルから離れずに行えます。
ツールキットドキュメント: composio.dev/toolkits/clockify
セットアップ
- Claude Codeの設定にRube MCPサーバーを追加します。URL:
https://rube.app/mcp - プロンプトに従い、表示される接続リンクからClockifyアカウントを認証します
- 自然言語でタイムトラッキングワークフローの自動化を開始します
コアワークフロー
1. 時間エントリの作成
プロジェクト、タスク、タグの関連付けと、課金可能ステータスを指定して時間を記録します。
ツール: CLOCKIFY_CREATE_TIME_ENTRY
ワークスペース64a687e3のプロジェクト64a687e2に、UTCで本日午前9時から「API開発」という説明で2時間の作業を記録
主要パラメータ:
workspaceId(必須) -- エントリを作成するワークスペースstart(必須) -- ISO 8601形式の開始時刻（例:2026-02-11T09:00:00Z）end-- ISO 8601形式の終了時刻。省略するとランニングタイマーを作成projectId-- プロジェクトに関連付けtaskId-- タスクに関連付けdescription-- 作業説明（0～3000文字）tagIds-- タグIDの配列billable-- エントリが課金可能かどうかcustomFieldValues--customFieldIdとvalueを持つカスタムフィールドエントリの配列
2. 時間エントリの照会
レポート、監査、請求書作成のために過去の時間エントリを取得します。
ツール: CLOCKIFY_GET_TIME_ENTRIES
ワークスペースxyz789のユーザーabc123の2026年1月のすべての時間エントリを取得
主要パラメータ:
workspaceId(必須) -- 照会するワークスペースuserId(必須) -- エントリを取得するユーザーstart/end-- ISO 8601形式の日付範囲フィルターproject-- プロジェクトIDでフィルターtask-- タスクIDでフィルターtags-- カンマ区切りのタグIDdescription-- テキストフィルター（部分一致）hydrated--trueに設定すると、IDだけでなくプロジェクト/タスク/タグの完全なオブジェクトを取得in-progress--trueに設定すると、実行中のタイマーのみを返すpage/page-size-- ページネーション（デフォルトは1ページ50件）
3. 時間エントリの削除
誤ったエントリ、重複、キャンセルされたエントリを削除します。
ツール: CLOCKIFY_DELETE_TIME_ENTRY
ワークスペース64a687e3の時間エントリ5b715448を削除
workspaceIdとid（時間エントリID）が必要- 不正なインポートや重複のクリーンアップに使用
4. ワークスペースの管理
認証済みユーザーが所属するすべてのワークスペースを一覧表示します。
ツール: CLOCKIFY_GET_ALL_MY_WORKSPACES
すべてのClockifyワークスペースを表示
- オプションの
rolesフィルター --["WORKSPACE_ADMIN", "OWNER"]のようなロールの配列 - エントリを作成・照会する前に、ワークスペースIDを調べるために使用
5. ユーザー情報
現在のユーザー詳細を取得し、ワークスペースメンバーを一覧表示します。
ツール: CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO, CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE
現在ログインしているユーザーは誰ですか？次に、ワークスペース64a687e3の全ユーザーを一覧表示
CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFOは認証済みユーザーのプロファイルを返します（パラメータ不要）CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACEはworkspaceIdが必要です。name、emailフィルターとページネーション（page、page-size最大100）に対応
6. ランニングタイマーの管理
作成時に end を省略してタイマーを開始するか、実行中のエントリを確認します。
ツール: CLOCKIFY_CREATE_TIME_ENTRY, CLOCKIFY_GET_TIME_ENTRIES
ワークスペースxyzのプロジェクトabcで「バグ修正中」という説明でタイマーを開始
endなしで作成するとランニングタイマーを開始CLOCKIFY_GET_TIME_ENTRIESをin-progress: trueで使用して、タイマーが実行中かどうかを確認
既知の落とし穴
- ワークスペースIDとユーザーIDは必須: ほとんどのClockifyツールでは
workspaceIdとuserIdの両方が必要です。最初にCLOCKIFY_GET_ALL_MY_WORKSPACESとCLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFOを呼び出して、これらのIDを解決してください。 - ISO 8601タイムスタンプ: すべての時刻パラメータはタイムゾーンを含むISO 8601形式（例:
2026-02-11T09:00:00Z）でなければなりません。タイムゾーンを省略すると予期しない動作を引き起こします。 - ランニングタイマー: 同時に実行できるタイマーは1つだけです。別のタイマーがすでにアクティブな場合、
endなしで新しいエントリを作成しようとすると失敗します。先に既存のタイマーを停止してください。 - ページネーションのデフォルト:
CLOCKIFY_GET_TIME_ENTRIESはデフォルトで1ページあたり50エントリを返します。完全なエクスポートを行うには、結果が返されなくなるまでページをループしてください。 - タグIDはワークスペーススコープ: あるワークスペースのタグIDを別のワークスペースで使用することはできません。常に対象のワークスペースコンテキスト内でタグを解決してください。
クイックリファレンス
| ツールスラッグ | 説明 |
|---|---|
CLOCKIFY_CREATE_TIME_ENTRY | 時間エントリを作成またはタイマーを開始（workspaceId、start が必要） |
CLOCKIFY_GET_TIME_ENTRIES | フィルター付きで時間エントリを一覧表示（workspaceId、userId が必要） |
CLOCKIFY_DELETE_TIME_ENTRY | 時間エントリを削除（workspaceId、id が必要） |
CLOCKIFY_GET_ALL_MY_WORKSPACES | 認証済みユーザーのすべてのワークスペースを一覧表示 |
CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO | 現在のユーザープロファイル情報を取得 |
CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE | ワークスペース内の全ユーザーを一覧表示（workspaceId が必要） |
Powered by Composio