Toggl Automation

Toggl Automation skill の概要

Toggl Automation でできること

Toggl Automation は、自然言語で Toggl Track を操作するための Claude Code skill です。タイマーの開始・停止、時間エントリの作成、作業とプロジェクトやタスクの紐づけ、クライアント・タグ・ワークスペースの管理を支援し、ターミナル、課題管理ツール、カレンダー、Toggl の間を行き来する手間を減らします。

この skill が向いている使い方

Toggl Automation skill は、すでに Toggl Track を使っていて、AI 支援のワークフロー内で時間記録まで完結させたい場合に特に有用です。プロジェクト、タグ、ワークスペースに正確に紐づいた時間エントリが必要な開発者、コンサルタント、制作会社、フリーランス、チームリードに向いています。とくに Workflow Automation において、時間記録がより大きな作業ルーチンの一部になっている場合に効果を発揮します。たとえば「デバッグ前にタイマーを開始する」「適切なクライアントに会議時間を記録する」「引き継ぎメモを作る前に現在のエントリを停止する」といった使い方です。

一般的なプロンプトとの違い

通常のプロンプトでも時間記録を促すことはできますが、Toggl の操作を安定して実行することはできません。この skill は、Rube MCP server 経由で公開される Toggl tools を前提に設計されており、時間エントリの作成やエントリ停止などに対応します。実務上の強みは、構造化された入力を扱える点です。workspace IDs、project IDs、timestamps、tags、descriptions を渡すことで、Claude は単なるチェックリストではなく、ツール実行に適したアクションへ変換できます。

Toggl Automation skill の使い方

Toggl Automation のインストールとセットアップ手順

この skill には rube MCP connection が必要です。Claude Code で、次の URL を使って Rube MCP server を追加します。

https://rube.app/mcp

Claude から求められたら、接続リンクを通じて Toggl Track アカウントを認証します。skill directory からインストールする場合は、directory の通常の skill installation flow に従い、そのうえで composio-skills/toggl-automation/SKILL.md が利用可能であり、MCP 要件が満たされていることを確認してください。上流の skill は主に SKILL.md の 1 ファイルで構成されているため、まずこのファイルを読むのが最短です。照合すべき追加の scripts/、resources/、README.md はありません。

skill を安定して動かすために必要な入力

Toggl Automation をうまく使うには、識別子と時間情報が重要です。安定した結果を得るには、次の情報を渡してください。

• workspace_id。Toggl の多くの操作はワークスペース単位で行われるためです
• エントリをプロジェクト単位で請求・集計したい場合は project_id または task_id
• 固定の時間エントリには ISO 8601 形式の start と stop
• 正確な終了時刻は不明だが経過時間が分かる場合は、秒単位の duration
• "meeting" や "design" のような配列形式のタグ名リスト
• "Client onboarding call" や "API debugging" のような明確な description

実行中のタイマーを作る場合は、stop と duration を省略します。完了済みのエントリを作る場合は、開始・終了の timestamps、または明示的な duration のどちらかを含めます。

Toggl Automation で使いやすいプロンプト例

弱いプロンプト:

Log my meeting time.

より良いプロンプト:

In Toggl workspace 123456, create a time entry for project 78910 with description "Design review session", tags "meeting" and "design", starting at 2026-07-12T14:00:00Z and stopping at 2026-07-12T14:45:00Z. Use created_with as "claude_code".

ライブタイマーの場合:

Start a running Toggl timer in workspace 123456 for project 78910, tagged "development", with description "Implement checkout validation". Use created_with as "claude_code" and start now.

作業を停止する場合:

Stop my current running Toggl time entry. Before calling the tool, confirm which workspace or active entry you will use if there is ambiguity.

本格利用の前に試すべきワークフロー

まず、既知のワークスペースでリスクの低いテストエントリを作成します。Toggl Track 上で、そのエントリが期待どおりのプロジェクト、タグ、説明になっているか確認してください。次に、実行中のエントリ停止をテストします。その後、会議、コーディング作業、サポート対応、事務作業、クライアントとの通話など、繰り返し発生する作業タイプごとに再利用しやすいプロンプトの型を作ります。よく使う workspace、project、tag IDs を小さなメモとして残しておくと、skill が毎回名前から推測する必要がなくなります。

Toggl Automation skill の FAQ

Toggl Automation は初心者にも使えますか？

はい。ただし、workspaces、projects、clients、tags、time entries といった Toggl Track の基本概念を理解していることが前提です。セットアップでは、Rube MCP server に接続して Toggl を認証するという追加手順があります。初心者の場合は、あらかじめ Toggl から、または過去に成功した tool calls から workspace IDs と project IDs を集めておくと、つまずきにくくなります。

この skill を使わないほうがよい場面は？

単なるリマインダー、タイムシートのテンプレート、一般的な生産性アドバイスだけが必要な場合には向いていません。また、組織が MCP connections をブロックしている場合、Rube 経由で Toggl を認証できない場合、AI agent に時間記録の作成・変更を任せることが許可されていない場合にも適しません。給与計算、請求、コンプライアンスに関わるログでは、最終データとして扱う前に必ずエントリを確認してください。

Toggl の標準 UI とは何が違いますか？

Toggl の UI は、レポートの閲覧、多数のエントリの視覚的な修正、ダッシュボードの確認に向いています。一方、Toggl Automation は、時間記録を別のターミナル中心のワークフローに組み込みたい場合に向いています。たとえば、Claude に作業計画を立ててもらいながらタイマーを開始したり、セッション要約後に停止したり、構造化されたメモから後追いの時間エントリを作成したりできます。

Workflow Automation で Toggl Automation を使うには正確な ID が必要ですか？

正確な ID の利用を強く推奨します。“Website Redesign” や “Acme” のような名前は、ワークスペースやクライアントをまたぐと曖昧になることがあります。IDs、timestamps、tags を指定すれば、skill が推測しなければならない判断が減り、誤った場所にエントリを作成するリスクを下げられます。

Toggl Automation skill を改善する方法

Toggl Automation の結果は文脈情報で改善できる

品質を大きく高めるには、慎重な人間のタイムキーパーが必要とする情報を同じように渡すことです。具体的には、workspace、project、task、time range、必要に応じた billable context、命名規則などです。「この作業を記録して」とだけ言うのではなく、どのカテゴリに属する作業なのか、実行中のタイマーなのか完了済みエントリなのか、レポート上でどのように表示したいのかを明確に伝えてください。

防ぎたいよくある失敗

よくある問題は、workspace IDs の不足、タイムゾーンの曖昧さ、実行中タイマーの重複、説明文の曖昧さ、レポート運用に合わないタグです。請求やクライアント記録に影響するエントリでは、実行前に Claude に予定している操作を復唱させることで防ぎやすくなります。たとえば次のように依頼します。「作成しようとしている Toggl entry について、workspace、project、start、stop、duration、tags を含めて要約し、すべての項目がそろっている場合のみ実行してください。」

最初の出力後に改善を重ねる

各 tool call が成功したら、Toggl を確認し、プロンプトの型を調整します。description が広すぎる場合は、Client - Activity - Outcome のような命名ルールを追加します。tags が一貫しない場合は、承認済みのタグ一覧を渡します。エントリが誤った project に作成される場合は、project names への依存をやめて project IDs を含めてください。小さなプロンプト制約を積み重ねるだけで、Toggl Automation は日常利用でかなり安定します。

メンテナー向けのリポジトリ確認手順

メンテナーや上級ユーザーは、composio-skills/toggl-automation/SKILL.md を最初から最後まで読んでください。特に、setup section、列挙されている Toggl tools、required parameters、example commands に注目します。この skill は現時点では補助 scripts や参照ファイルを持たない単一の skill file として提供されているため、改善するなら、より明確な examples、edge-case guidance、既存の time entries を変更する際のより安全な confirmation patterns を優先するとよいでしょう。