mcp-freshbooks

Produktionsreifer MCP-Server für FreshBooks — 53 Tools für Rechnungen, Kunden, Ausgaben, Zahlungen, Zeiterfassung, Projekte, Kostenvoranschläge, Finanzberichte und intelligente Workflows.

Funktionen

• 53 Tools, die den gesamten FreshBooks-Buchhaltungsworkflow abdecken

• Intelligente Workflow-Tools — Kostenvoranschläge in Rechnungen umwandeln, nicht abgerechnete Zeiten in Rechnung stellen, überfällige Kunden finden, vollständige Kundenzusammenfassungen abrufen

• 5 Finanzberichte — GuV, Steuerübersicht, Fälligkeitsübersicht, Bilanz, eingegangene Zahlungen

• OAuth2-Authentifizierung mit automatischer Token-Aktualisierung

• Saubere Ausgabe — zusammengefasste Listen, formatierte Details

• Produktionsreife Fehlerbehandlung und Berücksichtigung von Ratenbegrenzungen

• Keine Kosten — nutzt das kostenlose Entwicklerprogramm von FreshBooks

Related MCP server: moxie-mcp

Tools

Schnellstart

1. Installation

pip install mcp-freshbooks

Oder aus dem Quellcode:

git clone https://github.com/AlexlaGuardia/mcp-freshbooks.git
cd mcp-freshbooks
pip install .

2. FreshBooks API-Anmeldedaten abrufen

1. Registrieren Sie sich unter freshbooks.com/pages/developer-signup

2. Erstellen Sie eine OAuth-App im Entwicklerportal

3. Setzen Sie den Redirect-URI auf https://localhost:8555/callback

4. Kopieren Sie Ihre Client-ID und Ihr Client-Secret

3. Konfiguration

export FRESHBOOKS_CLIENT_ID=your_client_id
export FRESHBOOKS_CLIENT_SECRET=your_client_secret
export FRESHBOOKS_REDIRECT_URI=https://localhost:8555/callback

4. Zu Claude Desktop hinzufügen

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "freshbooks": {
      "command": "mcp-freshbooks",
      "env": {
        "FRESHBOOKS_CLIENT_ID": "your_client_id",
        "FRESHBOOKS_CLIENT_SECRET": "your_client_secret",
        "FRESHBOOKS_REDIRECT_URI": "https://localhost:8555/callback"
      }
    }
  }
}

5. Authentifizierung

Verwenden Sie bei der ersten Nutzung das Tool freshbooks_authenticate. Es wird Ihnen eine URL anzeigen, die Sie in Ihrem Browser öffnen können. Nach der Autorisierung werden die Token unter ~/.mcp-freshbooks/tokens.json gespeichert und automatisch aktualisiert.

Anwendungsbeispiele

Wer schuldet mir Geld?

Use get_overdue_invoices to see all past-due clients and total outstanding

Ein Angebot in eine Rechnung umwandeln:

Use convert_estimate_to_invoice to turn estimate 456 into a ready-to-send invoice

Nicht abgerechnete Arbeit finden:

Use get_unbilled_time to find time entries not yet on any invoice

Rentabilität prüfen:

Get the profit and loss report for Q1 2026

Zeit erfassen:

Create a 2-hour time entry for project 789 with note "API integration work"

Architektur

src/mcp_freshbooks/
├── server.py   # MCP server with 47 tool definitions
├── client.py   # FreshBooks API client (httpx async)
└── auth.py     # OAuth2 flow + token persistence

Der Server verwendet das MCP Python SDK mit FastMCP für eine saubere Tool-Registrierung. Alle API-Aufrufe erfolgen über den asynchronen Client mit automatischer Token-Aktualisierung.

Anforderungen

• Python 3.10+

• FreshBooks-Konto (kostenlose Testversion funktioniert für die Entwicklung)

• FreshBooks OAuth-App-Anmeldedaten

Lizenz

MIT