Toggl Automation
Claude Code から直接 Toggl Track のタイムトラッキング操作を自動化します。時間の記録、プロジェクトやクライアントの管理、タグによる整理、ワークスペースの制御を、ターミナルから離れずに行えます。
Toolkit ドキュメント: composio.dev/toolkits/toggl
セットアップ
- Rube MCP サーバーを Claude Code の設定に追加します（URL:
https://rube.app/mcp） - プロンプトが表示されたら、提供される接続リンクを使用して Toggl Track アカウントを認証します
- 自然言語でタイムトラッキングワークフローの自動化を開始します
コアワークフロー
1. 時間エントリの作成と停止
プロジェクト、タスク、タグを関連付けて時間を記録したり、タイマーの開始/停止を行います。
ツール: TOGGL_CREATE_TIME_ENTRY、TOGGL_PATCH_STOP_TIME_ENTRY
ワークスペース 123456 で、プロジェクト 78910 にタグ「meeting」と「design」を付けて、「Design review session」という説明で時間エントリを開始して
TOGGL_CREATE_TIME_ENTRY の主要パラメータ:
workspace_id（必須）-- 対象ワークスペースcreated_with（必須）-- クライアントアプリケーション名（例："api_client"）start（必須）-- ISO 8601 タイムスタンプstop-- ISO 8601 終了時刻。省略するとエントリは実行中のままduration-- 継続時間（秒）。実行中のエントリには省略project_id-- プロジェクトとの関連付けtask_id-- タスクとの関連付けtags-- タグ名の配列（ID ではありません）description-- 作業の説明billable-- 請求対象かどうか
TOGGL_PATCH_STOP_TIME_ENTRY の主要パラメータ:
workspace_id（必須）とtime_entry_id（必須）
2. プロジェクトの管理
新しいプロジェクトを作成し、既存のプロジェクトをクライアント情報とページネーション付きで一覧表示します。
ツール: TOGGL_CREATE_PROJECT、TOGGL_GET_PROJECTS、TOGGL_GET_PROJECT_DETAILS
ワークスペース 123456 内のクライアント 78910 向けに、「Q1 Marketing Campaign」という非公開の請求対象プロジェクトを作成して
TOGGL_CREATE_PROJECT の主要パラメータ:
workspace_id（必須）とname（必須）client_id、billable、is_private、active、colorestimated_hours、rate、fixed_fee、currency（プレミアム機能）
TOGGL_GET_PROJECTS の主要パラメータ:
workspace_id（必須）page/page_size（1～200）ページネーション用since/until-- 変更日時フィルタリング用の Unix タイムスタンプ（過去3か月のみ）clients: trueでクライアントの完全な詳細情報を含める
3. クライアントの管理
ワークスペース内でクライアントを作成および一覧表示します。
ツール: TOGGL_CREATE_CLIENT、TOGGL_GET_LIST_CLIENTS
ワークスペース 123456 のアクティブなクライアントをすべて一覧表示し、次に「Acme Corp」という新しいクライアントを作成して
TOGGL_CREATE_CLIENTはworkspace_idとnameが必須。notes、external_referenceを受け付けます。TOGGL_GET_LIST_CLIENTSはworkspace_idが必須。status（"active"、"archived"、"both"）とname（大文字小文字を区別しない検索）をサポートします。
4. タグとワークスペースの設定
分類用のタグを取得し、ワークスペースの設定を確認します。
ツール: TOGGL_GET_TAGS、TOGGL_GET_WORKSPACE_PREFERENCES
ワークスペース 123456 のすべてのタグとワークスペース設定を表示して
TOGGL_GET_TAGSはworkspace_idが必須。タグ ID と名前を返します。TOGGL_GET_WORKSPACE_PREFERENCESはworkspace_idが必須。料金プランと表示設定を返します。
5. ワークスペースの探索
認証済みユーザーが所属するすべてのワークスペースを一覧表示します。
ツール: TOGGL_GET_USER_WORKSPACES
どの Toggl ワークスペースにアクセスできますか？
- パラメータは不要です。
- すべてのワークスペースを ID、名前、メタデータとともに返します。
- 最初にこれを使用して、他の操作に必要な workspace_id を特定します。
6. ユーザープロジェクトの可視性
認証済みユーザーに表示可能なプロジェクトを一覧表示します。
ツール: TOGGL_GET_USER_PROJECTS
ワークスペース全体で自分が見られるすべてのプロジェクトを表示して
- 認証済みユーザーがアクセスできるプロジェクトを返します。
- ワークスペーススコープのビューには
TOGGL_GET_PROJECTSと併用します。
既知の注意点
- タグは ID ではなく名前を使用:
TOGGL_CREATE_TIME_ENTRYは多くの API のように ID ではなく、文字列としてのタグ名をtags配列に受け入れます。利用可能なタグ名を確認するにはTOGGL_GET_TAGSを使用してください。 created_withは必須: すべての時間エントリにcreated_with（例："api_client"）を含める必要があります。このフィールドがないと、エラーが発生せずに失敗します。- 継続時間は秒単位: 時間エントリの
durationパラメータは秒単位であり、時間単位ではありません。1時間 = 3600秒です。 sinceタイムスタンプ制限:TOGGL_GET_PROJECTSのsinceフィルターは過去3か月以内のタイムスタンプのみ許可されます。それより古いクエリは拒否されます。- プレミアム機能は制限あり: カスタムカラー、テンプレート、固定料金、プロジェクトの時間単価は Toggl のプレミアムプランが必要です。非プレミアムアカウントではこれらのフィールドを使用するとエラーが発生します。
- ワークスペース ID はほぼすべての場所で必須: ほとんどすべての Toggl ツールは
workspace_idを必要とします。最初にTOGGL_GET_USER_WORKSPACESを呼び出して解決してください。
クイックリファレンス
| ツールスラッグ | 説明 |
|---|---|
TOGGL_CREATE_TIME_ENTRY | 時間エントリまたは実行中のタイマーを作成（workspace_id、created_with、start が必要） |
TOGGL_PATCH_STOP_TIME_ENTRY | 実行中の時間エントリを停止（workspace_id、time_entry_id が必要） |
TOGGL_GET_PROJECTS | ワークスペース内のプロジェクトをページネーション付きで一覧表示 |
TOGGL_GET_PROJECT_DETAILS | 特定のプロジェクトの詳細を取得 |
TOGGL_CREATE_PROJECT | 新しいプロジェクトを作成（workspace_id、name が必要） |
TOGGL_GET_LIST_CLIENTS | ステータス/名前でフィルタリングしてクライアントを一覧表示（workspace_id が必要） |
TOGGL_CREATE_CLIENT | 新しいクライアントを作成（workspace_id、name が必要） |
TOGGL_GET_TAGS | ワークスペース内のすべてのタグを一覧表示（workspace_id が必要） |
TOGGL_GET_WORKSPACE_PREFERENCES | ワークスペース設定を取得（workspace_id が必要） |
TOGGL_GET_USER_WORKSPACES | 認証済みユーザーのすべてのワークスペースを一覧表示 |
TOGGL_GET_USER_PROJECTS | 認証済みユーザーに表示されるプロジェクトを一覧表示 |
Powered by Composio