QuickBooks Online MCP Server

Der QuickBooks Online MCP Server verbindet KI-Assistenten mit der Buchhaltungssoftware QuickBooks Online. MCP, das Model Context Protocol, ist ein offener Standard, über den Assistenten wie Claude Code externe Dienste ansprechen. Intuit, der Hersteller von QuickBooks, veröffentlicht den Server in seiner GitHub-Organisation. Er läuft lokal als stdio-Prozess, Ihr Client startet ihn also selbst auf Ihrem Rechner. Laut README stellt er 145 Werkzeuge bereit, die 29 Entitätstypen und 11 Finanzberichte abdecken.

Wofür ist der QuickBooks Online MCP Server nützlich?

Der Server richtet sich an Entwickler und Partner, die QuickBooks in eigene Abläufe einbinden oder KI-Prompts gegen echte Buchhaltungsstrukturen testen möchten. Ein Assistent kann damit etwa offene Rechnungen suchen, einen Bericht zu überfälligen Forderungen abrufen oder einen neuen Kunden samt Rechnung anlegen. Besonders praktisch ist das in der Sandbox, also einer Testumgebung mit einer Übungsfirma. Dort probieren Sie Abläufe aus, ohne echte Buchungen zu berühren. Wer nur im Chat Fragen zu seinen Zahlen stellen möchte, ist mit dem unten beschriebenen Connector meist besser bedient.

Welche Daten und Berichte deckt der Server ab?

Zu den Entitäten gehören laut README Kunden, Rechnungen, Zahlungen, Eingangsrechnungen, Lieferanten, Buchungssätze, Klassen und Abteilungen. Für die meisten stehen Werkzeuge zum Anlegen, Lesen, Suchen, Ändern und Löschen bereit. Steuercodes, Steuersätze und Steuerbehörden sind nur lesbar. Bei den Berichten nennt das Repository unter anderem Bilanz, Gewinn- und Verlustrechnung, Cashflow, Saldenliste, Hauptbuch und die Altersstruktur von Forderungen und Verbindlichkeiten. Das Löschen ist nicht überall gleich: Manche Werkzeuge stornieren einen Beleg, andere entfernen einen Datensatz. Lesen Sie deshalb die Beschreibung des jeweiligen Werkzeugs, bevor Sie es freigeben.

Einrichtung und Anmeldung

Der Aufwand ist höher als bei vielen gehosteten Servern. Es gibt keine persönlichen API-Schlüssel, Sie registrieren stattdessen eine eigene App im Intuit Developer Portal und erhalten so Client-ID und Client-Secret. Die Anmeldung läuft über OAuth 2.0, ein Standardverfahren für delegierten Zugriff. In der Sandbox genügt die lokale Adresse http://localhost:8000/callback und der Befehl npm run auth. Für echte Firmendaten akzeptiert Intuit keine lokale Adresse. Laut README brauchen Sie dann einmalig eine öffentliche HTTPS-Adresse, zum Beispiel über einen ngrok-Tunnel. Danach läuft der Server ohne Browser weiter, solange das Refresh-Token innerhalb von 100 Tagen erneuert wird.

Was unterscheidet ihn vom QuickBooks-Connector?

Intuit bietet zusätzlich einen gehosteten Connector für Claude und ein Plugin für ChatGPT an. Das sind getrennte Angebote. Für den Connector brauchen Sie keine Entwickler-App, Sie melden sich auf claude.ai einfach mit Ihrem Intuit-Konto an. Seit dem 28. Juli 2026 kann er laut Intuit auch Rechnungen erstellen und versenden. Laut Hilfeartikel ist er derzeit aber nur für Kunden in den USA verfügbar. Das Open-Source-Repository nennt keine solche Einschränkung und richtet sich eher an technische Teams. Es arbeitet zudem direkt auf den Buchhaltungsobjekten, während der Connector auf festgelegte Anwendungsfälle zugeschnitten ist. Im Vergleich zum Xero MCP Server fällt auf, dass QuickBooks nicht fertig per npx startet, sondern geklont und gebaut wird.

Reifegrad und Lizenz

Das Repository besteht seit Oktober 2025 und wird weiter gepflegt, der letzte Push stammt vom September 2026. Es gibt aber keine veröffentlichten Releases, die Paketversion steht auf 0.0.1. Bei der Lizenz widersprechen sich die Angaben. Die LICENSE-Datei und GitHub nennen Apache 2.0, die README und die package.json dagegen MIT. Wir führen Apache 2.0, weil die Lizenzdatei maßgeblich ist. Wenn das für Ihr Unternehmen wichtig ist, klären Sie es vorab.

Kosten

Der Server selbst ist kostenlos. Für echte Daten brauchen Sie ein QuickBooks-Online-Konto, dessen Tarife Intuit auf seiner Preisseite aufführt. Der kostenlose Free-Tarif enthält laut dieser Seite keine Drittanbieter-Integrationen, prüfen Sie ihn also vorab. Außerdem können Kosten für Ihr KI-Modell anfallen.

Für wen lohnt sich der QuickBooks Online MCP Server?

Er lohnt sich für Entwickler, Integrationspartner und technische Finanzteams, die volle Kontrolle über die Anbindung möchten und mit OAuth-Apps vertraut sind. Weniger geeignet ist er für Selbstständige ohne technischen Hintergrund. Da es um Finanzdaten geht, sollten Sie in jedem Fall zuerst in der Sandbox beginnen, die Schreibwerkzeuge abschalten und Änderungen erst nach einer Prüfung freigeben.

Git und Node.js mit npm, eine App im Intuit Developer Portal, eine QuickBooks-Online-Sandbox oder ein QuickBooks-Online-Konto sowie ein MCP-Client wie Claude Code. Die README nennt keine Mindestversion für Node.js.

Mit dem QuickBooks Online MCP Server von Intuit greift Ihr KI-Assistent lokal auf Buchhaltungsdaten zu. Dieser Ratgeber zeigt die Einrichtung mit einer Sandbox, also einer Testumgebung mit Übungsfirma, und mit Claude Code. Danach geht es um den Wechsel zu echten Daten.

Schritt 1: Voraussetzungen

Sie brauchen Git, Node.js mit npm und ein Konto im Intuit Developer Portal. Die README nennt keine Mindestversion für Node.js. Wenn Sie nur im Chat mit Ihren Zahlen arbeiten möchten und in den USA sind, prüfen Sie zuerst den QuickBooks-Connector für Claude. Er kommt ohne eigene App aus.

Schritt 1: Server bauen

Klonen Sie das Repository mit git clone https://github.com/intuit/quickbooks-online-mcp-server.git. Wechseln Sie in den Ordner und führen Sie npm install und npm run build aus. Die Beispieladresse in der README enthält einen Platzhalter, verwenden Sie deshalb die Adresse aus diesem Ratgeber.

Schritt 2: App im Developer Portal anlegen

Registrieren Sie im Intuit Developer Portal eine App und notieren Sie Client-ID und Client-Secret. Tragen Sie als Redirect-URI http://localhost:8000/callback ein. Die Adresse muss bei Protokoll, Host, Port und Pfad exakt mit Ihrer Konfiguration übereinstimmen.

Schritt 2: Sandbox verbinden

Kopieren Sie .env.example nach .env und tragen Sie QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET und QUICKBOOKS_ENVIRONMENT=sandbox ein. Starten Sie npm run auth. Der Browser öffnet sich, und Sie melden sich bei der Sandbox-Firma an. Die Tokens landen danach in der .env-Datei.

Schritt 3: Claude Code verbinden

Führen Sie claude mcp add --scope user quickbooks -- node /absoluter/pfad/quickbooks-online-mcp-server/dist/index.js aus und passen Sie den Pfad an. Der Server sucht die .env-Datei neben dem gebauten Modul, nicht im aktuellen Arbeitsordner. Unter /mcp in Claude Code sehen Sie, ob die Verbindung steht.

Schreibzugriffe absichern

Setzen Sie am Anfang QUICKBOOKS_DISABLE_WRITE, QUICKBOOKS_DISABLE_UPDATE und QUICKBOOKS_DISABLE_DELETE auf "true". Dann registriert der Server die Werkzeuge zum Anlegen, Ändern und Löschen gar nicht erst. Lesewerkzeuge bleiben verfügbar. Geben Sie Schreibrechte erst frei, wenn Ihre Abläufe in der Sandbox zuverlässig laufen.

Schritt 4: Erste Aufgaben

Beginnen Sie mit Fragen, die nur lesen. Zum Beispiel: Welche Rechnungen sind überfällig? Zeige mir die Gewinn- und Verlustrechnung des letzten Quartals. Vergleichen Sie die Antworten mit der Oberfläche von QuickBooks. So erkennen Sie, ob der Assistent die Berichte richtig liest.

Wechsel zu echten Daten

Für Production lehnt Intuit lokale Redirect-Adressen ab. Laut README brauchen Sie einmalig eine öffentliche HTTPS-Adresse, etwa über einen ngrok-Tunnel oder einen eigenen Callback-Dienst. Danach genügt das Refresh-Token, das sich beim Erneuern selbst austauscht. Prüfen Sie vor dem Wechsel, ob Ihr QuickBooks-Tarif Drittanbieter-Integrationen enthält, und lassen Sie Buchhaltungsergebnisse fachlich gegenlesen.

git clone https://github.com/intuit/quickbooks-online-mcp-server.git && cd quickbooks-online-mcp-server && npm install && npm run build

OAuth 2.0 über eine eigene App im Intuit Developer Portal. Nötig sind QUICKBOOKS_CLIENT_ID, QUICKBOOKS_CLIENT_SECRET, QUICKBOOKS_REFRESH_TOKEN, QUICKBOOKS_REALM_ID und QUICKBOOKS_ENVIRONMENT. Ein einmaliger Browser-Handshake genügt, danach erneuert der Server das Token selbst, solange das 100-Tage-Fenster nicht abläuft.

Der Server arbeitet mit einer Firma, die über QUICKBOOKS_REALM_ID festgelegt ist. Lesewerkzeuge sind immer aktiv. Mit QUICKBOOKS_DISABLE_WRITE, QUICKBOOKS_DISABLE_UPDATE und QUICKBOOKS_DISABLE_DELETE auf "true" werden Werkzeuge zum Anlegen, Ändern und Löschen gar nicht erst registriert. Im Konfigurationsbeispiel der README stehen diese Schalter auf "false".

Der Server läuft auf Ihrem Rechner und spricht direkt mit der QuickBooks-API. Tokens liegen im Klartext in der .env-Datei oder in der Datei unter QUICKBOOKS_TOKEN_STORE_PATH. Was ein Werkzeug zurückgibt, sieht auch Ihr KI-Modell, Finanz- und Kundendaten gehen also je nach Client an dessen Anbieter. Intuits Aussage, Daten nicht zum Training zu nutzen, steht im Hilfeartikel zum Connector und nicht im Repository.

Hoch. Ein Agent kann Buchungen, Rechnungen und Zahlungen ändern oder löschen, sobald die Schreibwerkzeuge aktiv sind. Texte aus Kundendaten oder Rechnungsnotizen können zudem versteckte Anweisungen enthalten (Prompt Injection). Beginnen Sie in der Sandbox, setzen Sie die drei DISABLE-Schalter auf "true" und lassen Sie jeden Aufruf bestätigen. Die .env-Datei gehört nicht in ein Repository oder ein geteiltes Laufwerk.