ComposioHQ/FreshBooks-Automation

FreshBooks Automation

FreshBooks の操作を自動化します。事業一覧の取得、プロジェクト管理、タイムトラッキング、予算監視など、中小企業向け会計業務を効率化します。

ツールキットドキュメント: composio.dev/toolkits/freshbooks

---

セットアップ

このスキルを使用するには、https://rube.app/mcp に接続された Rube MCP サーバー が必要です。

ツールを実行する前に、freshbooks ツールキットのアクティブな接続が存在することを確認してください。接続がない場合は、RUBE_MANAGE_CONNECTIONS を介して接続を開始してください。

---

コアワークフロー

1. 事業一覧の取得

認証済みユーザーに関連付けられたすべての事業を取得します。このレスポンスの business_id は、他のほとんどの FreshBooks API 呼び出しで必要になります。

ツール: FRESHBOOKS_LIST_BUSINESSES

パラメータ: なし

例:

Tool: FRESHBOOKS_LIST_BUSINESSES
Arguments: {}

出力: ユーザーがアクセス権を持つすべての事業と、各事業におけるロールを含む事業メンバーシップ情報を返します。

重要: プロジェクト固有の操作を実行する前に、必ずこのツールを呼び出して有効な business_id を取得してください。

---

2. プロジェクトの一覧表示とフィルタリング

包括的なフィルタリングと並べ替えオプションを使用して、事業のすべてのプロジェクトを取得します。

ツール: FRESHBOOKS_LIST_PROJECTS

主なパラメータ:

• business_id (必須) -- FRESHBOOKS_LIST_BUSINESSES から取得した事業 ID
• active -- アクティブ状態でフィルタリング: true (アクティブのみ)、false (非アクティブのみ)、省略すると全て
• complete -- 完了状態でフィルタリング: true (完了済み)、false (未完了)、省略すると全て
• sort_by -- 並べ替え順: "created_at"、"due_date"、または "title"
• updated_since -- RFC3339 形式の UTC 日時（例: "2026-01-01T00:00:00Z"）
• include_logged_duration -- true にするとプロジェクトごとの総ログ時間（秒）を含める
• skip_group -- true にするとチームメンバー/招待データを省略（レスポンスサイズを削減）

例:

Tool: FRESHBOOKS_LIST_PROJECTS
Arguments:
  business_id: 123456
  active: true
  complete: false
  sort_by: "due_date"
  include_logged_duration: true

ユースケース:

• タイムトラッキングや請求書作成のために全プロジェクトを取得
• 顧客、ステータス、日付範囲でプロジェクトを検索
• プロジェクト完了状況と予算追跡を監視
• チーム割り当てとプロジェクトグループを取得

---

3. アクティブプロジェクトの監視

アクティブで未完了のプロジェクトをフィルタリングして、プロジェクトの進捗と予算を追跡します。

手順:

1. FRESHBOOKS_LIST_BUSINESSES を呼び出して business_id を取得
2. FRESHBOOKS_LIST_PROJECTS を active: true、complete: false、include_logged_duration: true で呼び出し
3. 各プロジェクトのログ時間と予算を分析

---

4. 最近更新されたプロジェクトの確認

updated_since フィルターを使用して、最近のプロジェクト活動を確認します。

手順:

1. FRESHBOOKS_LIST_BUSINESSES を呼び出して business_id を取得
2. FRESHBOOKS_LIST_PROJECTS を、updated_since に基準日時を設定して呼び出し
3. 返されたプロジェクトを確認し、最近の変更を特定

例:

Tool: FRESHBOOKS_LIST_PROJECTS
Arguments:
  business_id: 123456
  updated_since: "2026-02-01T00:00:00Z"
  sort_by: "created_at"

---

推奨実行計画

1. FRESHBOOKS_LIST_BUSINESSES を呼び出して 事業 ID を取得
2. 取得した business_id を使用して FRESHBOOKS_LIST_PROJECTS で プロジェクトを一覧表示
3. active、complete、updated_since、sort_by パラメータを使って 必要に応じてフィルタリング

---

既知の問題点

問題点	詳細
business_id 必須	ほとんどの FreshBooks 操作には business_id が必要です。最初に必ず FRESHBOOKS_LIST_BUSINESSES を呼び出して取得してください。
日付形式	updated_since パラメータは RFC3339 形式（"2026-01-01T00:00:00Z"）でなければなりません。他の形式は失敗します。
ページネーション	プロジェクト一覧のレスポンスはページネーションされています。レスポンス内の追加ページを確認してください。
空の結果	プロジェクトが存在しない、または適用されたフィルターに一致しない場合は空のリストを返します。これはエラーではありません。
ログ時間の単位	include_logged_duration が true の場合、時間は秒単位で返されます。表示するには時間に変換（3600 で除算）してください。

---

クイックリファレンス

ツールスラッグ	説明
FRESHBOOKS_LIST_BUSINESSES	認証済みユーザーの全事業を一覧表示
FRESHBOOKS_LIST_PROJECTS	フィルタリングと並べ替えで事業のプロジェクトを一覧表示

---

Powered by Composio