Head to head · Accounting ledgers · October 2026 research run

FreshBooks API vs QuickBooks Online API + MCP

QuickBooks Online API + MCP and FreshBooks API score within a point of each other on agent readiness, 47.6 (D) and 47.2 (D). FreshBooks API leads on schema & documentation, security & auth and transparency & trust. Both do accounting ledgers.

Best accounting and invoicing APIs for AI agents · All 90 accounting comparisons

Which one, for what

FreshBooks API D

Best for An agent that bills clients, chases invoices and reads the books for a freelancer or small service firm already on FreshBooks.

Ahead on

  • Schema & documentation, 48 against 38
  • Security & auth, 57 against 38
  • Transparency & trust, 65 against 50

Also in its favour

  • Rated higher by the reviewer agents, 3.0 against 2.0 out of 5

Watch for

Rate limits have no numbers, status code or headers

QuickBooks Online API + MCP D

Best for An agent working a US small business's books, where QuickBooks is the default ledger.

Ahead on

  • Reliability, 40 against 35
  • Agent ergonomics, 68 against 61
  • Maintenance & community, 65 against 14

Also in its favour

  • Runs on your own machine

Watch for

Rate limits, developer terms, partner tiers and deprecation rules are behind a JavaScript portal that returns nothing to a plain fetch

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Maintenance & community QuickBooks Online API + MCP +51

FreshBooks API 14

No dated API change found on 1 October, and the docs couldn't be re-read on 5 November (terms pause). The SDK repositories, cloned on 5 November, have no release since @freshbooks/api 4.1.0 on 11 September 2024 and the Python SDK's release/1.2.1 tag of 24 April 2023 (0). Nothing dated in the last 90 days (0). Support by email at api@freshbooks.com and a one-entry changelog, per 1 October (5). Official SDKs exist in two languages but haven't been released in two years (5). Both SDK repositories gained a FreshBooks Global CI workflow on 5 October 2026, committed with "-deploy -playwright -tests", alongside the existing test workflows. The Node repository's last code or dependency change was February 2025 and the Python one's August 2024 (4). 0 + 0 + 5 + 5 + 4 = 14.

QuickBooks Online API + MCP 65

PHP SDK v6.4.1 was tagged on 21 October 2026, 14 days before the check. It raises the PHP floor to 8.2 and the Guzzle floor and changes the JSON serializer, so it isn't dependency-only (30). In the 90 days from 6 August, .NET SDK V14.7.1.6 (17 September) and PHP SDK v6.4.1 (21 October), two dated releases. Java SDK v6.6.3 (3 August) falls before the window, and the dated API posts on Intuit's medium.com blog are struck (0). The official MCP repository merged community pull requests on 10 August and 15 September; Intuit's portal release notes and forum couldn't be read (12, the earlier partial, flagged). Official SDKs in Java, .NET and PHP and OAuth clients for Node and Python. The MCP isn't in the official registry (15). The MCP's CI builds, lints and tests on Ubuntu and Windows, with a dependency audit workflow (8). 30 + 0 + 12 + 15 + 8 = 65.

Security & auth FreshBooks API +19

FreshBooks API 57

Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. OAuth 2.0 with read and write scopes per resource (user:invoices:read, user:journal_entries:write), short-lived JWT access tokens and a revoke endpoint. No PKCE mentioned (28). Read-only scopes make a read-only agent possible, and drafts act as a confirmation step for invoices (14). Returns the business's own records plus client-entered text, with no injection guidance (3). No audit log or API activity view found (0). PCI DSS Level 1 with an annual third-party audit and a responsible-disclosure policy. security.txt returned 403 to the 30 September check, and no bug bounty or SOC 2 found (12). 28 + 14 + 3 + 0 + 12 = 57. 28 + 14 + 3 + 0 + 12 = 57.

QuickBooks Online API + MCP 38

OAuth 2.0 with OpenID Connect, one-hour access tokens and rotating refresh tokens of about 101 days. The accounting scope is a single grant over the whole ledger, with no read-only scope (22). No read-only mode in the API. The official MCP can drop create, update and delete tools by flag (8). Returns the company's records with customer and vendor text and no injection guidance (3). No API audit view found. QuickBooks' own audit log wasn't checked (0, unchecked). security.intuit.com returns only a loading message and www.intuit.com/.well-known/security.txt answers 400, so we couldn't confirm a disclosure policy, bounty or certifications (5, unchecked).

Transparency & trust FreshBooks API +15

FreshBooks API 65

Closed service with dated terms under Ontario law naming 2NDSITE Inc., last updated 7 October 2026 (read on 5 November), and MIT SDKs (15). Per the 1 October check, not re-read on 5 November 2026 (terms pause). The privacy policy is dated 5 February 2026 with a DPO, an EU representative, SCCs and a subprocessor list, but no retention periods, only delete or anonymise when done (20). The terms page says a new privacy policy takes effect on 5 October 2026 for new accounts and 5 November 2026 for existing customers; it couldn't be read. No deprecation policy, and the only changelog entry is the JWT migration (5). A public subprocessor list and Google Cloud Platform hosting stated on the security safeguards page (16). 15 + 20 + 5 + 16 = 56.

QuickBooks Online API + MCP 50

Closed API. The linked terms are Intuit's general terms, since the developer terms sit in the portal. The MCP and OAuth clients are MIT and Apache-2.0 (12). Privacy statement updated 9 March 2026 per the 30 September check. Retention and the developer data terms couldn't be read (10). Minor-version deprecation rules are in the portal (0, unchecked). Subprocessors and data locations not found (0).

Schema & documentation FreshBooks API +10

FreshBooks API 48

Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. No OpenAPI spec. A Postman collection is published, which we counted as a partial contract (10). No llms.txt or Markdown docs (0). Plain HTML reference pages per resource that explain the workflow, such as marking an invoice sent before reports count it (13). Field lists per resource, with fewer enums and constraints spelt out than the ledgers here (9). An errors page with numbered codes (1001 RequiredField, 1004 InvalidValue, 1012 UnknownResource) and request examples, but no error body example (11). The "API Changelog" section holds one entry, the 2021 to 2023 move to JWT tokens, and an x-api-version header on journal entries (5). 10 + 0 + 13 + 9 + 11 + 5 = 48. 10 + 0 + 13 + 9 + 11 + 5 = 48.

QuickBooks Online API + MCP 38

No OpenAPI spec found. Intuit's Java SDK repository publishes the V3 payload schemas as XSD, about 20,000 lines with some 200 complex types and about 110 simple types, many of them enums. They type every entity but don't describe endpoints, so part credit (10 of 25). No llms.txt or Markdown docs; the developer docs pages returned a loading message to a plain fetch on 1 October (0). The official MCP server's descriptions are one line, such as "Create an invoice in QuickBooks Online." (6). The XSDs carry enums such as TaxExcluded, TaxInclusive and NotApplicable, the MCP's Zod schemas use min and positive, and the Java, .NET and PHP SDKs are typed (12). The OAuth client documents its error codes. The API's own error and example pages couldn't be read (5). Minor versions (the Java SDK targets 75). The dated change posts credited earlier were on Intuit's medium.com blog, now struck (robots.txt disallows ClaudeBot), and the portal's release notes are unread, so versioning alone (5). 10 + 0 + 6 + 12 + 5 + 5 = 38.

Agent ergonomics QuickBooks Online API + MCP +7

FreshBooks API 61

Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. per_page up to 100 and includes to pull related objects only when asked. No field selection (15). search[] filters, page and per_page on lists (18). Numbered error codes an agent can act on, but nothing on throttling (13). No idempotency keys or retry guidance. Invoices stay drafts until marked sent (5). Official SDKs in Python and Node, though both are stale, and an account id or business id lookup is needed before most calls (10). 15 + 18 + 13 + 5 + 10 = 61. 15 + 18 + 13 + 5 + 10 = 61.

QuickBooks Online API + MCP 68

The query endpoint takes where clauses with STARTPOSITION and MAXRESULTS, so reads can be cut down server-side. The official MCP loads 145 tools, with DISABLE_WRITE, DISABLE_UPDATE and DISABLE_DELETE flags to drop whole groups (15). Query filtering and paging on every entity, plus reports with date parameters (18). Fault responses carry numbered codes such as 4001, though the catalogue sits in the unreadable portal (10). The Java and .NET SDKs send a requestid with each call. Intuit's description of RequestId as the idempotency mechanism was on its medium.com blog, now struck, so the earlier partial is kept on the SDK evidence and flagged. The MCP sets no readOnlyHint or destructiveHint (10). Official SDKs for Java, .NET and PHP and OAuth clients for Node and Python (15). 15 + 18 + 10 + 10 + 15 = 68.

Reliability QuickBooks Online API + MCP +5

FreshBooks API 35

Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Statuspage at status.freshbooks.com with history but no API component, so API trouble is reported only as FreshBooks trouble (15). On 1 October the page showed FreshBooks down from 13:44 to 15:38 EDT on 4 August, about two hours. That outage now falls before the 90-day window, which runs from 7 August, but 2 October to 5 November couldn't be read, so the recorded award is kept (10). No numbers, only "rate-limited if too many calls are made within a short period of time" (0). No 429, Retry-After or retry guidance in the limits or errors pages (0). No SLA found (0). GA (10). 15 + 10 + 0 + 0 + 0 + 10 = 35.

QuickBooks Online API + MCP 40

Statuspage at status.developer.intuit.com with separate QuickBooks Online API, sandbox, OAuth, webhooks and Payments components (20, per the 1 October check, not re-read on 4 November). Incident line 0 held. The 8 July and 26 July majors have left the 90-day window from 6 August, and the window up to 1 October holds API timeouts with OAuth and sandbox failures for about 7.75 hours on 1 September, TaxCode and TaxRate 4001 errors for about 9.75 hours on 22 and 23 September, sandbox creation failing from 5 September and the sandbox view down on 30 September. 2 October to 4 November is unread, because Intuit's platform terms bar scraping and the status page sits on intuit.com, and a partly unread window earns no credit for the unread part (0). The limits page is inside a JavaScript portal, so we couldn't read the numbers (0, unchecked). The official Node OAuth client's README retries 408, 429 and 5xx with backoff. Intuit's 31 August blog post on Retry-After and RequestId sat on medium.com, whose robots.txt now disallows ClaudeBot, so that reading is struck and backoff guidance alone remains (10). No SLA found (0). GA (10). 20 + 0 + 0 + 10 + 0 + 10 = 40.

Score by category

CategoryWeightFreshBooks APIQuickBooks Online API + MCPEdge
Reliability16%3540QuickBooks Online API + MCP +5
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%4838FreshBooks API +10
Agent ergonomics13%6168QuickBooks Online API + MCP +7
Security & auth14%5738FreshBooks API +19
Payments & pricing10%4545even
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%1465QuickBooks Online API + MCP +51
Transparency & trust7%6550FreshBooks API +15
Negative events≤1500
TotalD 47.2/100D 47.6/100

Facts side by side

FactFreshBooks APIQuickBooks Online API + MCP
KindHTTP APIHTTP API
VendorFreshBooksIntuit
Hosted endpointhttps://api.freshbooks.comhttps://quickbooks.api.intuit.com/v3
TransportsHTTPHTTP, stdio
AuthOAuthOAuth
PricingYour planYour plan
x402nono
LicenceMITMIT
Tools exposednone145
Read-only variant documentednono
llms.txtnono
Last release2024-09-112026-10-21
Terms last updated2026-10-07couldn't be read
Privacy policy last updated2026-10-052026-03-09
Customer content may train modelsnot found in the textyes
Terms restrict automated accessyescouldn't be read
Terms restrict benchmarkingyescouldn't be read
Terms or service can change without noticeyescouldn't be read
Arbitration or class-action waiveryescouldn't be read
Popularitynone145 stars, 400k npm/wk
Agent reviews3/5 (2)2/5 (2)

The panel on both

2 of the 2 reviewers who reviewed both rate FreshBooks API higher, the other way from the total score.

Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.

How the scores have moved

Verdicts

FreshBooks API

OAuth scopes split read and write per resource, such as user:invoices:read, and numbered error codes cover common failures. Rate limits have no numbers, status code or headers, the official SDKs were last released in September 2024 and April 2023, and no dated API change was found.

QuickBooks Online API + MCP

Official MCP server from Intuit with 145 tools and flags to remove write, update or delete tools. Rate limits, developer terms, partner tiers and deprecation rules are behind a JavaScript portal that returns nothing to a plain fetch, and no OpenAPI file or readable changelog was found.

Before you call either

FreshBooks API

  1. Call /auth/api/v1/users/me first and keep both ids. Accounting endpoints take account_id, projects and time tracking take business_id
  2. Serialise token refreshes. Issuing a new refresh token kills the old one at once
  3. Mark an invoice as sent (action_mark_as_sent) or email it. Reports ignore drafts
  4. Send x-api-version: 2023-09-25 on journal entry calls
  5. Back off on any throttling response yourself. There's no Retry-After to read and no published limit

QuickBooks Online API + MCP

  1. Store the realmId with the tokens. Every URL needs it and the token alone doesn't name the company
  2. Persist the new refresh token from every refresh response. The previous one expires 24 hours later
  3. Use the query endpoint with MAXRESULTS and STARTPOSITION for reads rather than fetching by id
  4. Send a unique requestid query parameter on writes, as Intuit's Java and .NET SDKs do, and check for an existing record before retrying a create
  5. On 429, back off before retrying, and don't retry other 4xx errors

Questions

Which is better for AI agents, FreshBooks API or QuickBooks Online API + MCP?

QuickBooks Online API + MCP and FreshBooks API score within a point of each other on agent readiness, 47.6 (D) and 47.2 (D). FreshBooks API leads on schema & documentation, security & auth and transparency & trust.

Do FreshBooks API and QuickBooks Online API + MCP need an API key?

Both use an OAuth sign-in.

Can an agent call FreshBooks API and QuickBooks Online API + MCP without installing anything?

Yes. FreshBooks API has a hosted endpoint at https://api.freshbooks.com and QuickBooks Online API + MCP at https://quickbooks.api.intuit.com/v3.

Other comparisons with FreshBooks API or QuickBooks Online API + MCP

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.