Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Freshbooks MCP

von chrischallVersion 1.3.1i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.chrischall/freshbooks-mcp

So installierst du es

What it does

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

  • Connects Läuft auf deinem Computer
  • Account or key Needs FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE · 1 setting to fill in (FRESHBOOKS_REDIRECT_URI)
  • Category Buchhaltung, Finanzen & Steuern

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit18/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert30/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: 29 (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Freshbooks MCP. Folge https://mcp.popnx.com/i/chrischall-freshbooks-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Freshbooks MCP (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (FRESHBOOKS_REDIRECT_URI) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Freshbooks MCP für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "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) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Freshbooks MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Bei Freshbooks MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • FRESHBOOKS_REDIRECT_URI Registrierte Redirect-URI; auch bei Refresh-Aufrufen erforderlich (Standard https://localhost).
      Englisches Original anzeigenRegistered redirect URI; required on refresh calls too (default https://localhost)

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  5. Diese Einstellungen einfügen und speichern

    {
      "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"
          }
        }
      }
    }

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. Claude beenden und neu öffnen

  7. Ausprobieren

    Nutze Freshbooks MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Freshbooks MCP nutzt, oder ein Werkzeug von Freshbooks MCP in der Antwort zeigt, bist du verbunden

4 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • FRESHBOOKS_CLIENT_ID OAuth-Client-ID von my.freshbooks.com//developer
    Englisches Original anzeigenOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_BUSINESS_ID Die ganzzahlige businessId, mit der gearbeitet werden soll, wenn die authentifizierte Identität zu mehreren Unternehmen gehört. Ohne sie verwenden Lesevorgänge das erste von FreshBooks aufgelistete Unternehmen, und Schreibvorgänge werden abgelehnt, statt im falschen Unternehmen zu landen.
    Englisches Original anzeigenThe 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 Überschreibt die Konto-ID, die normalerweise über /auth/api/v1/users/me ermittelt wird. Explizit setzen, wenn die authentifizierte Identität keiner Geschäftsmitgliedschaft angehört und die Ermittlung fehlschlägt, oder zusammen mit FRES….
    Englisches Original anzeigenOverrides 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 Frist pro Anfrage für API-Aufrufe in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request deadline for API calls, in milliseconds (default 30000)

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Freshbooks MCP noch nicht verbinden

Freshbooks MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Freshbooks MCP verbinden kann

  • Du brauchst einen Schlüssel von Freshbooks MCP (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (FRESHBOOKS_REDIRECT_URI) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Du brauchst einen Schlüssel von Freshbooks MCP (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (FRESHBOOKS_REDIRECT_URI) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Freshbooks MCP (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (FRESHBOOKS_REDIRECT_URI) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Freshbooks MCP (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (FRESHBOOKS_REDIRECT_URI) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Buchhaltung, Finanzen & Steuern, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Freshbooks MCP (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (FRESHBOOKS_REDIRECT_URI) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Freshbooks MCP für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): 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) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Freshbooks MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Bei Freshbooks MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • FRESHBOOKS_REDIRECT_URI Registrierte Redirect-URI; auch bei Refresh-Aufrufen erforderlich (Standard https://localhost).
      Englisches Original anzeigenRegistered redirect URI; required on refresh calls too (default https://localhost)

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  5. Diesen Befehl einfügen und Enter drücken

    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

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. /mcp in Claude Code eingeben

    Freshbooks MCP sollte in der Liste als verbunden erscheinen

  7. Ausprobieren

    Nutze Freshbooks MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Freshbooks MCP nutzt, oder ein Werkzeug von Freshbooks MCP in der Antwort zeigt, bist du verbunden

4 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • FRESHBOOKS_CLIENT_ID OAuth-Client-ID von my.freshbooks.com//developer
    Englisches Original anzeigenOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_BUSINESS_ID Die ganzzahlige businessId, mit der gearbeitet werden soll, wenn die authentifizierte Identität zu mehreren Unternehmen gehört. Ohne sie verwenden Lesevorgänge das erste von FreshBooks aufgelistete Unternehmen, und Schreibvorgänge werden abgelehnt, statt im falschen Unternehmen zu landen.
    Englisches Original anzeigenThe 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 Überschreibt die Konto-ID, die normalerweise über /auth/api/v1/users/me ermittelt wird. Explizit setzen, wenn die authentifizierte Identität keiner Geschäftsmitgliedschaft angehört und die Ermittlung fehlschlägt, oder zusammen mit FRES….
    Englisches Original anzeigenOverrides 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 Frist pro Anfrage für API-Aufrufe in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request deadline for API calls, in milliseconds (default 30000)

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Freshbooks MCP (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (FRESHBOOKS_REDIRECT_URI) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Freshbooks MCP für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "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) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Freshbooks MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Bei Freshbooks MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • FRESHBOOKS_REDIRECT_URI Registrierte Redirect-URI; auch bei Refresh-Aufrufen erforderlich (Standard https://localhost).
      Englisches Original anzeigenRegistered redirect URI; required on refresh calls too (default https://localhost)

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von Freshbooks MCP ist FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in Cursor im Agent-Modus öffnen

  7. Ausprobieren

    Nutze Freshbooks MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Freshbooks MCP nutzt, oder ein Werkzeug von Freshbooks MCP in der Antwort zeigt, bist du verbunden

4 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • FRESHBOOKS_CLIENT_ID OAuth-Client-ID von my.freshbooks.com//developer
    Englisches Original anzeigenOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_BUSINESS_ID Die ganzzahlige businessId, mit der gearbeitet werden soll, wenn die authentifizierte Identität zu mehreren Unternehmen gehört. Ohne sie verwenden Lesevorgänge das erste von FreshBooks aufgelistete Unternehmen, und Schreibvorgänge werden abgelehnt, statt im falschen Unternehmen zu landen.
    Englisches Original anzeigenThe 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 Überschreibt die Konto-ID, die normalerweise über /auth/api/v1/users/me ermittelt wird. Explizit setzen, wenn die authentifizierte Identität keiner Geschäftsmitgliedschaft angehört und die Ermittlung fehlschlägt, oder zusammen mit FRES….
    Englisches Original anzeigenOverrides 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 Frist pro Anfrage für API-Aufrufe in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request deadline for API calls, in milliseconds (default 30000)

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Freshbooks MCP (auf der Seite des Anbieters erstellen) · 1 Einstellung(en) auszufüllen (FRESHBOOKS_REDIRECT_URI) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Freshbooks MCP für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "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) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Freshbooks MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Bei Freshbooks MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 1 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • FRESHBOOKS_REDIRECT_URI Registrierte Redirect-URI; auch bei Refresh-Aufrufen erforderlich (Standard https://localhost).
      Englisches Original anzeigenRegistered redirect URI; required on refresh calls too (default https://localhost)

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von Freshbooks MCP ist FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE, FRESHBOOKS_REDIRECT_URI leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in VS Code im Agent-Modus öffnen

  7. Ausprobieren

    Nutze Freshbooks MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Freshbooks MCP nutzt, oder ein Werkzeug von Freshbooks MCP in der Antwort zeigt, bist du verbunden

4 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • FRESHBOOKS_CLIENT_ID OAuth-Client-ID von my.freshbooks.com//developer
    Englisches Original anzeigenOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_BUSINESS_ID Die ganzzahlige businessId, mit der gearbeitet werden soll, wenn die authentifizierte Identität zu mehreren Unternehmen gehört. Ohne sie verwenden Lesevorgänge das erste von FreshBooks aufgelistete Unternehmen, und Schreibvorgänge werden abgelehnt, statt im falschen Unternehmen zu landen.
    Englisches Original anzeigenThe 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 Überschreibt die Konto-ID, die normalerweise über /auth/api/v1/users/me ermittelt wird. Explizit setzen, wenn die authentifizierte Identität keiner Geschäftsmitgliedschaft angehört und die Ermittlung fehlschlägt, oder zusammen mit FRES….
    Englisches Original anzeigenOverrides 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 Frist pro Anfrage für API-Aufrufe in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request deadline for API calls, in milliseconds (default 30000)

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Freshbooks MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

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"
      }
    }
  }
}

Werte, die du selbst einträgst

  • FRESHBOOKS_CLIENT_ID env
    OAuth-Client-ID von my.freshbooks.com//developer
    Englisches Original anzeigenOAuth client ID from my.freshbooks.com/#/developer
  • FRESHBOOKS_CLIENT_SECRET geheim erforderlich env
    OAuth-Client-Secret
    Englisches Original anzeigenOAuth client secret
  • FRESHBOOKS_REFRESH_TOKEN geheim erforderlich env
    Optional für die lokale Anmeldung, die Tokens privat speichert. Erforderlich für gehostete oder veraltete Umgebungstoken-Einrichtungen.
    Englisches Original anzeigenOptional for local sign-in, which saves tokens privately. Required for hosted or legacy environment-token setup.
  • FRESHBOOKS_REDIRECT_URI erforderlich env
    Registrierte Redirect-URI; auch bei Refresh-Aufrufen erforderlich (Standard https://localhost).
    Englisches Original anzeigenRegistered redirect URI; required on refresh calls too (default https://localhost)
  • FRESHBOOKS_TOKEN_STORE geheim erforderlich env
    Pfad des Speichers für rotierende Refresh-Tokens (Standard /.freshbooks-mcp/session.json)
    Englisches Original anzeigenPath for the rotating-refresh-token store (default ~/.freshbooks-mcp/session.json)
  • FRESHBOOKS_BUSINESS_ID env
    Die ganzzahlige businessId, mit der gearbeitet werden soll, wenn die authentifizierte Identität zu mehreren Unternehmen gehört. Ohne sie verwenden Lesevorgänge das erste von FreshBooks aufgelistete Unternehmen, und Schreibvorgänge werden abgelehnt, statt im falschen Unternehmen zu landen.
    Englisches Original anzeigenThe 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
    Überschreibt die Konto-ID, die normalerweise über /auth/api/v1/users/me ermittelt wird. Explizit setzen, wenn die authentifizierte Identität keiner Geschäftsmitgliedschaft angehört und die Ermittlung fehlschlägt, oder zusammen mit FRES….
    Englisches Original anzeigenOverrides 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
    Frist pro Anfrage für API-Aufrufe in Millisekunden (Standard 30000).
    Englisches Original anzeigenPer-request deadline for API calls, in milliseconds (default 30000)

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
585/Wo.
Verbindung
Läuft auf deinem Computer
Neueste Versioni
1.3.1
In der Registry veröffentlichti
5. Nov. 2026
Code zuletzt geänderti
11. Nov. 2026
Entwickler
chrischall
Pakete
npm: @chrischall/freshbooks-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto chrischall bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 8 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für @chrischall/freshbooks-mcp@1.3.1

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

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

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

  • Mehr Sterne als 0 % der anderen 3407 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 69 % der anderen 3407 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 3407 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Freshbooks MCP sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN, FRESHBOOKS_TOKEN_STORE

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 8 Tagen geändert, und die neueste Version (1.3.1) kam vor 14 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

SolidInvoice

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

von SolidInvoiceWachsend★ 989Aktualisiert vor 10 Tagen

Läuft in der Cloud✓ vom Dienst · solidinvoice.co

Signal8

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

von signal8aiWachsend↓ 431/Wo.★ 425Aktualisiert vor 10 Tagen

Computer oder Cloud✓ vom Dienst · signal8.ai

Journalit

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

von CursivezWachsend★ 261Aktualisiert vor 11 Tagen

Läuft in der Cloud✓ vom Dienst · journalit.co

Beancount.io

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

von bex-coWachsend★ 688 Sterne des ganzen ReposAktualisiert vor 44 Tagen

Läuft in der Cloud✓ vom Dienst · beancount.io
Im Vergleich mit ähnlichen
Dieser
Freshbooks MCP
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem Rechner
Braucht SchlüsselJaNeinJaNeinNeinJa
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen3/34/65/54/44/45/5
LizenzMITMITMITNOASSERTIONMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo