プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Freshbooks MCP

作者:chrischallバージョン 1.3.1i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.chrischall/freshbooks-mcp

インストール方法

What it does

FreshBooks invoicing for Claude — invoices, clients, estimates, and payments

  • Connects パソコンで動く
  • Account or key Needs FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE · 1 setting to fill in (FRESHBOOKS_REDIRECT_URI)
  • Category 会計・財務・税務

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気18/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア30/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: 29 (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Freshbooks MCP をインストールして。https://mcp.popnx.com/i/chrischall-freshbooks-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

Freshbooks MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FRESHBOOKS_REDIRECT_URI) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Freshbooks MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "freshbooks": { "command": "npx", "args": [ "-y", "@chrischall/freshbooks-mcp" ], "env": { "FRESHBOOKS_CLIENT_SECRET": "your-value", "FRESHBOOKS_REFRESH_TOKEN": "your-value", "FRESHBOOKS_REDIRECT_URI": "your-value", "FRESHBOOKS_TOKEN_STORE": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Freshbooks MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Freshbooks MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • FRESHBOOKS_REDIRECT_URI Registered redirect URI; required on refresh calls too (default https://localhost)

    説明は英語の原文のままです。

  4. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  5. この設定を貼り付けて保存

    {
      "mcpServers": {
        "freshbooks": {
          "command": "npx",
          "args": [
            "-y",
            "@chrischall/freshbooks-mcp"
          ],
          "env": {
            "FRESHBOOKS_CLIENT_SECRET": "your-value",
            "FRESHBOOKS_REFRESH_TOKEN": "your-value",
            "FRESHBOOKS_REDIRECT_URI": "your-value",
            "FRESHBOOKS_TOKEN_STORE": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

    Freshbooks MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Freshbooks MCP を使っていると言うか、回答に Freshbooks MCP のツール名が出れば接続成功です

追加の設定 4 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • FRESHBOOKS_CLIENT_ID my.freshbooks.com//developer の OAuth クライアント ID
    英語の原文を見るOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_BUSINESS_ID 認証済みの ID が複数の事業に属する場合に使用する整数の businessId。指定しない場合、読み取りは FreshBooks が一覧に挙げる最初の事業を使い、書き込みは誤った事業に記録されないよう拒否されます。
    英語の原文を見るThe integer businessId to work in when the authenticated identity belongs to several businesses. Without it, reads use the first business FreshBooks lists and writes are refused rather than landing i…
  • FRESHBOOKS_ACCOUNT_ID 通常 /auth/api/v1/users/me から解決されるアカウント ID を上書きします。認証済みの ID がどのビジネスメンバーシップにも属しておらず、解決に失敗する場合は明示的に設定してください。または FRES… と併用する場合にも設定します。
    英語の原文を見るOverrides the account id normally resolved from /auth/api/v1/users/me. Set it explicitly when the authenticated identity belongs to no business membership and resolution fails, or, together with FRES…
  • FRESHBOOKS_REQUEST_TIMEOUT_MS API 呼び出しごとの期限(ミリ秒、デフォルト 30000)。
    英語の原文を見るPer-request deadline for API calls, in milliseconds (default 30000)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Freshbooks MCP につなげません

Freshbooks MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Freshbooks MCP につなげるアプリを使う

  • Freshbooks MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FRESHBOOKS_REDIRECT_URI) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Freshbooks MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FRESHBOOKS_REDIRECT_URI) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • Freshbooks MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FRESHBOOKS_REDIRECT_URI) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • Freshbooks MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FRESHBOOKS_REDIRECT_URI) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 会計・財務・税務 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

Freshbooks MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FRESHBOOKS_REDIRECT_URI) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Freshbooks MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user freshbooks --env FRESHBOOKS_CLIENT_SECRET=your-value --env FRESHBOOKS_REFRESH_TOKEN=your-value --env FRESHBOOKS_REDIRECT_URI=your-value --env FRESHBOOKS_TOKEN_STORE=your-value -- npx -y @chrischall/freshbooks-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Freshbooks MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Freshbooks MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • FRESHBOOKS_REDIRECT_URI Registered redirect URI; required on refresh calls too (default https://localhost)

    説明は英語の原文のままです。

  4. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  5. このコマンドを貼り付けて Enter

    claude mcp add --scope user freshbooks --env FRESHBOOKS_CLIENT_SECRET=your-value --env FRESHBOOKS_REFRESH_TOKEN=your-value --env FRESHBOOKS_REDIRECT_URI=your-value --env FRESHBOOKS_TOKEN_STORE=your-value -- npx -y @chrischall/freshbooks-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

    Freshbooks MCP が一覧にあり、接続済みと表示されれば OK です

  7. 試してみる

    Freshbooks MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Freshbooks MCP を使っていると言うか、回答に Freshbooks MCP のツール名が出れば接続成功です

追加の設定 4 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • FRESHBOOKS_CLIENT_ID my.freshbooks.com//developer の OAuth クライアント ID
    英語の原文を見るOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_BUSINESS_ID 認証済みの ID が複数の事業に属する場合に使用する整数の businessId。指定しない場合、読み取りは FreshBooks が一覧に挙げる最初の事業を使い、書き込みは誤った事業に記録されないよう拒否されます。
    英語の原文を見るThe integer businessId to work in when the authenticated identity belongs to several businesses. Without it, reads use the first business FreshBooks lists and writes are refused rather than landing i…
  • FRESHBOOKS_ACCOUNT_ID 通常 /auth/api/v1/users/me から解決されるアカウント ID を上書きします。認証済みの ID がどのビジネスメンバーシップにも属しておらず、解決に失敗する場合は明示的に設定してください。または FRES… と併用する場合にも設定します。
    英語の原文を見るOverrides the account id normally resolved from /auth/api/v1/users/me. Set it explicitly when the authenticated identity belongs to no business membership and resolution fails, or, together with FRES…
  • FRESHBOOKS_REQUEST_TIMEOUT_MS API 呼び出しごとの期限(ミリ秒、デフォルト 30000)。
    英語の原文を見るPer-request deadline for API calls, in milliseconds (default 30000)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

Freshbooks MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FRESHBOOKS_REDIRECT_URI) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Freshbooks MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "freshbooks": { "command": "npx", "args": [ "-y", "@chrischall/freshbooks-mcp" ], "env": { "FRESHBOOKS_CLIENT_SECRET": "your-value", "FRESHBOOKS_REFRESH_TOKEN": "your-value", "FRESHBOOKS_REDIRECT_URI": "your-value", "FRESHBOOKS_TOKEN_STORE": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Freshbooks MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Freshbooks MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • FRESHBOOKS_REDIRECT_URI Registered redirect URI; required on refresh calls too (default https://localhost)

    説明は英語の原文のままです。

  4. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  5. キーを入力

    Freshbooks MCP の設定で FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Cursor の AI チャットを Agent モードで開く

  7. 試してみる

    Freshbooks MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Freshbooks MCP を使っていると言うか、回答に Freshbooks MCP のツール名が出れば接続成功です

追加の設定 4 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • FRESHBOOKS_CLIENT_ID my.freshbooks.com//developer の OAuth クライアント ID
    英語の原文を見るOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_BUSINESS_ID 認証済みの ID が複数の事業に属する場合に使用する整数の businessId。指定しない場合、読み取りは FreshBooks が一覧に挙げる最初の事業を使い、書き込みは誤った事業に記録されないよう拒否されます。
    英語の原文を見るThe integer businessId to work in when the authenticated identity belongs to several businesses. Without it, reads use the first business FreshBooks lists and writes are refused rather than landing i…
  • FRESHBOOKS_ACCOUNT_ID 通常 /auth/api/v1/users/me から解決されるアカウント ID を上書きします。認証済みの ID がどのビジネスメンバーシップにも属しておらず、解決に失敗する場合は明示的に設定してください。または FRES… と併用する場合にも設定します。
    英語の原文を見るOverrides the account id normally resolved from /auth/api/v1/users/me. Set it explicitly when the authenticated identity belongs to no business membership and resolution fails, or, together with FRES…
  • FRESHBOOKS_REQUEST_TIMEOUT_MS API 呼び出しごとの期限(ミリ秒、デフォルト 30000)。
    英語の原文を見るPer-request deadline for API calls, in milliseconds (default 30000)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

Freshbooks MCP のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (FRESHBOOKS_REDIRECT_URI) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Freshbooks MCP を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "freshbooks": { "type": "stdio", "command": "npx", "args": [ "-y", "@chrischall/freshbooks-mcp" ], "env": { "FRESHBOOKS_CLIENT_SECRET": "your-value", "FRESHBOOKS_REFRESH_TOKEN": "your-value", "FRESHBOOKS_REDIRECT_URI": "your-value", "FRESHBOOKS_TOKEN_STORE": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Freshbooks MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Freshbooks MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • FRESHBOOKS_REDIRECT_URI Registered redirect URI; required on refresh calls too (default https://localhost)

    説明は英語の原文のままです。

  4. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  5. キーを入力

    Freshbooks MCP の設定で FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. VS Code の AI チャットを Agent モードで開く

  7. 試してみる

    Freshbooks MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Freshbooks MCP を使っていると言うか、回答に Freshbooks MCP のツール名が出れば接続成功です

追加の設定 4 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • FRESHBOOKS_CLIENT_ID my.freshbooks.com//developer の OAuth クライアント ID
    英語の原文を見るOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_BUSINESS_ID 認証済みの ID が複数の事業に属する場合に使用する整数の businessId。指定しない場合、読み取りは FreshBooks が一覧に挙げる最初の事業を使い、書き込みは誤った事業に記録されないよう拒否されます。
    英語の原文を見るThe integer businessId to work in when the authenticated identity belongs to several businesses. Without it, reads use the first business FreshBooks lists and writes are refused rather than landing i…
  • FRESHBOOKS_ACCOUNT_ID 通常 /auth/api/v1/users/me から解決されるアカウント ID を上書きします。認証済みの ID がどのビジネスメンバーシップにも属しておらず、解決に失敗する場合は明示的に設定してください。または FRES… と併用する場合にも設定します。
    英語の原文を見るOverrides the account id normally resolved from /auth/api/v1/users/me. Set it explicitly when the authenticated identity belongs to no business membership and resolution fails, or, together with FRES…
  • FRESHBOOKS_REQUEST_TIMEOUT_MS API 呼び出しごとの期限(ミリ秒、デフォルト 30000)。
    英語の原文を見るPer-request deadline for API calls, in milliseconds (default 30000)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Freshbooks MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user freshbooks --env FRESHBOOKS_CLIENT_SECRET=your-value --env FRESHBOOKS_REFRESH_TOKEN=your-value --env FRESHBOOKS_REDIRECT_URI=your-value --env FRESHBOOKS_TOKEN_STORE=your-value -- npx -y @chrischall/freshbooks-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "freshbooks": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/freshbooks-mcp"
      ],
      "env": {
        "FRESHBOOKS_CLIENT_SECRET": "your-value",
        "FRESHBOOKS_REFRESH_TOKEN": "your-value",
        "FRESHBOOKS_REDIRECT_URI": "your-value",
        "FRESHBOOKS_TOKEN_STORE": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "freshbooks": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/freshbooks-mcp"
      ],
      "env": {
        "FRESHBOOKS_CLIENT_SECRET": "your-value",
        "FRESHBOOKS_REFRESH_TOKEN": "your-value",
        "FRESHBOOKS_REDIRECT_URI": "your-value",
        "FRESHBOOKS_TOKEN_STORE": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "freshbooks": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/freshbooks-mcp"
      ],
      "env": {
        "FRESHBOOKS_CLIENT_SECRET": "your-value",
        "FRESHBOOKS_REFRESH_TOKEN": "your-value",
        "FRESHBOOKS_REDIRECT_URI": "your-value",
        "FRESHBOOKS_TOKEN_STORE": "your-value"
      }
    }
  }
}

自分で入力する値

  • FRESHBOOKS_CLIENT_ID env
    my.freshbooks.com//developer の OAuth クライアント ID
    英語の原文を見るOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_CLIENT_SECRET 秘密 必須 env
    OAuthクライアントシークレット
    英語の原文を見るOAuth client secret
  • FRESHBOOKS_REFRESH_TOKEN 秘密 必須 env
    ローカルサインインでは任意です。トークンはプライベートに保存されます。ホスト型または従来の環境トークン設定では必須です。
    英語の原文を見るOptional for local sign-in, which saves tokens privately. Required for hosted or legacy environment-token setup.
  • FRESHBOOKS_REDIRECT_URI 必須 env
    Registered redirect URI; required on refresh calls too (default https://localhost)
  • FRESHBOOKS_TOKEN_STORE 秘密 必須 env
    ローテーションするリフレッシュトークンの保存先パス(既定は /.freshbooks-mcp/session.json)
    英語の原文を見るPath for the rotating-refresh-token store (default ~/.freshbooks-mcp/session.json)
  • FRESHBOOKS_BUSINESS_ID env
    認証済みの ID が複数の事業に属する場合に使用する整数の businessId。指定しない場合、読み取りは FreshBooks が一覧に挙げる最初の事業を使い、書き込みは誤った事業に記録されないよう拒否されます。
    英語の原文を見るThe integer businessId to work in when the authenticated identity belongs to several businesses. Without it, reads use the first business FreshBooks lists and writes are refused rather than landing i…
  • FRESHBOOKS_ACCOUNT_ID env
    通常 /auth/api/v1/users/me から解決されるアカウント ID を上書きします。認証済みの ID がどのビジネスメンバーシップにも属しておらず、解決に失敗する場合は明示的に設定してください。または FRES… と併用する場合にも設定します。
    英語の原文を見るOverrides the account id normally resolved from /auth/api/v1/users/me. Set it explicitly when the authenticated identity belongs to no business membership and resolution fails, or, together with FRES…
  • FRESHBOOKS_REQUEST_TIMEOUT_MS env
    API 呼び出しごとの期限(ミリ秒、デフォルト 30000)。
    英語の原文を見るPer-request deadline for API calls, in milliseconds (default 30000)

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
585/週
接続方法
パソコンで動く
最新バージョンi
1.3.1
レジストリ公開日i
2026年11月5日
コードの最終更新i
2026年11月18日
作者
chrischall
パッケージ
npm: @chrischall/freshbooks-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント chrischall で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に @chrischall/freshbooks-mcp@1.3.1 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/chrischall-freshbooks-mcp.svg)](https://mcp.popnx.com/en/servers/chrischall-freshbooks-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

会計・財務・税務のほかのサーバーとの比較i

  • このカテゴリのほかの3417件のうち0%よりスターが多い
  • このカテゴリのほかの3417件のうち68%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3417件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Freshbooks MCPは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(1.3.1)がレジストリに届いたのは14 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

作者:SolidInvoice成長中★ 98910 日前更新

クラウドで動く✓ 提供元 · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

作者:signal8ai成長中↓ 431/週★ 42510 日前更新

パソコンでもクラウドでも✓ 提供元 · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

作者:Cursivez成長中★ 26111 日前更新

クラウドで動く✓ 提供元 · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

作者:bex-co成長中★ 702 リポジトリ全体のスター44 日前更新

クラウドで動く✓ 提供元 · beancount.io
似たものと比べる
これ
Freshbooks MCP
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使える
キーが必要はいいいえはいいいえいいえはい
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/65/54/44/45/5
ライセンスMITMITMITNOASSERTIONMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

freshbooks-mcp

MCP server for FreshBooks — invoices, clients, estimates and payments, exposed to Claude as typed tools.

This project was developed and is maintained by AI (Claude Code). Use at your own discretion.

Install

npm install -g @chrischall/freshbooks-mcp

Setup

FreshBooks is OAuth2 only — there is no API key and no personal access token, so a one-time browser authorization is required.

  1. Register an app at https://my.freshbooks.com/#/developer. The redirect URI must be HTTPS with no query string; https://localhost works and never needs to resolve.
  2. Note the Client ID and Client Secret.
  3. Complete the one-time authorization:
  • From the server itself (no script): set FRESHBOOKS_CLIENT_ID and FRESHBOOKS_CLIENT_SECRET, start it, then call freshbooks_auth_url, open the URL it returns, approve, and pass the whole URL you land on to freshbooks_auth_exchange. Its state must match a consent URL the server issued (valid 15 minutes, single-use), so a bare code, or a redirect URL from anyone else's authorization, is refused before its code is spent. Local sessions save the tokens directly to FRESHBOOKS_TOKEN_STORE and return only a success message. Restart the local MCP server after that message. No token needs to be copied into chat or configuration. Keep the same app credentials and store path after restart.
  • Hosted connections: mcp-host's authFlow still captures the refresh token from the exchange response and supplies it through its secret store. MCP_DATA_DIR identifies this hosted environment. Do not set it for a local coding-agent connection: hosted mode intentionally returns the token. Issued states are kept as digests under MCP_DATA_DIR, so a child that is respawned while the person approves can still complete the login. The registration's flow must show the person the `authorize_url` that `freshbooks_auth_url` returns. That URL carries the one-time state, and the exchange refuses any redirect without it. A static consent link typed into a step description has no state, so every new login or repair through it fails. Carry authorize_url from the freshbooks_auth_url step and show it with a step link (link: {from: 'authorize_url', hosts: ['auth.freshbooks.com']}, mcp-host 2.30.0 or later) on the step that prompts. That prompt must collect the whole redirect URL, not just its code. Make this change before a release with state checking reaches the hosted pin. Existing connections keep refreshing; only new logins and repairs depend on it.
  • Legacy/manual setup: the scripts in skills/freshbooks-curl print tokens. Run them only in a private terminal, never in an agent's captured terminal.
  1. Configure:
FRESHBOOKS_CLIENT_ID=...

FRESHBOOKS_CLIENT_SECRET=... FRESHBOOKS_REFRESH_TOKEN=... # optional locally; if set during reauth, keep it set FRESHBOOKS_REDIRECT_URI=https://localhost # optional; must match what you registered FRESHBOOKS_TOKEN_STORE=~/.freshbooks-mcp/session.json # optional FRESHBOOKS_BUSINESS_ID=... # optional; required for writes if you belong to several businesses FRESHBOOKS_ACCOUNT_ID=... # optional; with FRESHBOOKS_BUSINESS_ID, confirms its accountId when FreshBooks omits it FRESHBOOKS_REQUEST_TIMEOUT_MS=30000 # optional; per-request deadline for API calls

In Claude Desktop, both are optional fields in the extension's settings. If FreshBooks returns no account_id for the chosen business, invoice/expense writes are refused (projects and time entries still work) until you set both IDs yourself.

⚠️ Refresh tokens rotate

FreshBooks issues a new refresh token on every refresh and immediately invalidates the old one. This server persists each rotation to FRESHBOOKS_TOKEN_STORE (mode 0600) before the refresh is considered complete, and prefers the stored token over the environment value — the stored one has rotated past it.

The login flow also writes a small file of pending consent state digests (mode 0600, entries expire after 15 minutes). Locally it sits beside the token store, at .oauth-state.json (by default ~/.freshbooks-mcp/session.json.oauth-state.json). Hosted, it is $MCP_DATA_DIR/freshbooks-oauth-state.json. It is created on the first freshbooks_auth_url call, even if the login is never finished, and holds no tokens.

Two consequences worth knowing:

  • Do not point two tools at the same store. The MCP server and the freshbooks-curl skill keep separate state files on purpose; sharing one makes them spend each other's tokens and locks both out.
  • If the store is lost, re-run the bootstrap. A spent refresh token cannot be recovered.

Local sign-in without an environment token binds the private store to the app's client ID, secret, and redirect URI. Changing those requires a new sign-in. For existing environment-token setups, the stored rotation still takes precedence; changing FRESHBOOKS_REFRESH_TOKEN to a new value starts a new token chain. If you reauthorize locally while FRESHBOOKS_REFRESH_TOKEN is set, keep that same value configured: the saved login is bound to it. To remove the variable, first unset it and complete local sign-in again so the store is bound to the app instead. The local authorization exchange and save use the same lock as refreshes. A refresh writes only while it holds that lock, so it cannot overwrite a newer login after releasing the lock. Restart every local server using the store after reauthorization.

Tools

ToolPurpose
freshbooks_get_identityResolve accountId / businessId / businessUuid
freshbooks_auth_urlGet the consent URL to authorize this connection
freshbooks_auth_exchangeComplete authorization; save tokens privately in local sessions or return the refresh token to the hosted auth flow
freshbooks_healthcheckVerify the OAuth credential and FreshBooks reachability; distinguishes "no credential" from "rejected" from "FreshBooks is down"
freshbooks_list_invoices / freshbooks_get_invoiceBrowse and fetch invoices
freshbooks_list_clients / freshbooks_get_clientBrowse and fetch clients
freshbooks_list_estimates / freshbooks_get_estimateBrowse and fetch estimates
freshbooks_list_payments / freshbooks_get_paymentBrowse and fetch payments
freshbooks_list_items / freshbooks_get_itemBrowse and fetch catalogue items
freshbooks_create_clientCreate a client — confirmation-gated
freshbooks_create_invoiceCreate an invoice — confirmation-gated
freshbooks_update_invoiceUpdate an invoice — confirmation-gated
freshbooks_record_paymentRecord a payment against an invoice — confirmation-gated
freshbooks_accept_estimateAccept an estimate (action_accept) — confirmation-gated, idempotent
freshbooks_update_estimateUpdate an estimate's lines, notes, terms, presentation — confirmation-gated
freshbooks_send_estimateEmail an estimate to the client (action_email) — confirmation-gated
freshbooks_decline_estimateAlways fails: FreshBooks has no decline. Answers with the alternatives
freshbooks_list_expenses / freshbooks_get_expenseBrowse and fetch expenses
freshbooks_list_expense_categoriesCategories supplying categoryid for new expenses
freshbooks_create_expenseRecord an expense — confirmation-gated
freshbooks_list_projects / freshbooks_get_projectProjects (businessId-keyed)
freshbooks_create_projectCreate a project — confirmation-gated
freshbooks_list_time_entriesTracked time, with total_logged / total_unbilled
freshbooks_create_time_entryLog time in seconds — confirmation-gated
freshbooks_list_servicesBillable work types for projects and time entries
freshbooks_list_records / freshbooks_get_recordGeneric accessor for the accounting long tail (taxes, credit notes, invoice profiles, tasks, staff, gateways, bills, bill vendors, bill payments, other income)

Confirmation-gated means the tool asks you before it writes. A client that can show a confirmation prompt (Claude Code) shows one with exactly what would be sent. Elsewhere (claude.ai, Claude Desktop) the first call makes *no* network call and returns a preview of the method, path and body that would be sent, plus a single-use confirmToken; only a repeat call with that token and the same arguments performs the write. A token is refused if any argument changed since the preview (DRAFT_CHANGED), if it was already used (TOKEN_REUSED) or once it expires.

Confirmations
variabledefault
MCP_CONFIRM_MODEask-userWhat a write does on a client that cannot show a confirmation prompt (claude.ai, Claude Desktop). ask-user: two steps — the first call does nothing and returns a preview plus a token, and the model must get your approval in chat before calling again with it. auto: the same two steps, but the model may use the token after reviewing the preview itself. refuse: writes are refused on such clients. A client that can show prompts (Claude Code) always gets the real prompt, unless MCP_CONFIRM_ELICITATION=off. An unrecognised value is treated as refuse.
MCP_CONFIRM_ELICITATIONonoff never shows a confirmation prompt, so every client gets the MCP_CONFIRM_MODE behaviour. Set it for a client that says it can show prompts but never does (the write hangs — opencode 2.0.x). Any other value is treated as on, with a warning on stderr.
MCP_CONFIRM_TTL_SECONDS600How long a token stays valid.
MCP_CONFIRM_SECRETrandom per processSigning key; set it only if tokens must survive a server restart.
Estimate writes

Acceptance is an action on the estimate, not a status field: status (int), display_status and ui_status are computed and read-only, and they disagree with each other by design (a viewed estimate reads status: 3, display_status: "viewed", ui_status: "open"). Accepting is PUT estimates/estimates/{id} with {"estimate": {"action_accept": true}} — see docs/FRESHBOOKS-API.md for where that shape comes from.

  • Accept is idempotent. An estimate already accepted (or invoiced) comes back with changed: false and no write is sent — acceptance cannot be undone through the API, so a repeat call must not re-fire it.
  • There is no decline. FreshBooks' estimate statuses are draft / sent / viewed / replied / accepted / invoiced; no declined state, no action_deny, no estimate.decline webhook. freshbooks_decline_estimate exists only to say so and point at the alternatives, rather than leave an agent to invent a write that changes nothing.
  • Every write returns the re-fetched estimate, plus before / after state and changed / changedFields, so success is verified against the record rather than inferred from a 200. changed covers the status fields *and* the fields that write actually set, so a successful notes edit reports changed: true even though no status moves. On freshbooks_send_estimate it describes the record only — emailing an already-sent estimate moves nothing, and retrying on changed: false would send the client a second copy.

Writes require an owner/admin accounting account

FreshBooks separates the role you hold on a *business* from the role you hold on an *accounting account*. You can own a business that has no accounting account (account_id: null) while being only a client on the account you can actually see — in which case reads succeed and every write returns 403 Permission Denied, even though y

冒頭だけを表示しています。続きはリポジトリで読めます