{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}
At a glance
- Availability: Experimental (how to enable).
- Authentication: OAuth 2.0.
- Connection: A user authorizes the connection in the provider's consent screen.
- Scopes:
com.intuit.quickbooks.accounting. - Provider documentation: Authentication reference.
Credentials
Set these per environment. See Connect an integration.
These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.
Setup
- Create an Intuit developer account: Sign up at https://developer.intuit.com/. Creating an app automatically provisions a QuickBooks Online sandbox company with sample data for testing.
- Create an app: In the developer dashboard (https://developer.intuit.com/app/developer/dashboard), create an app for the QuickBooks Online and Payments platform with the com.intuit.quickbooks.accounting scope, and add your /api/auth/quickbooks/callback URL as a redirect URI.
- Copy credentials: From the app's Keys & credentials page, copy the Client ID and Client Secret (Development keys work against the sandbox host; Production keys require app review). Set QUICKBOOKS_CLIENT_ID and QUICKBOOKS_CLIENT_SECRET in your .env.
- Note your realm ID: The OAuth callback includes a realmId query parameter identifying the connected company. Save it; every QuickBooks tool requires it as the realmId parameter. You can also find it under the gear icon > Additional Info in QuickBooks Online.
- Verify access: Run the List Invoices tool with your realmId (set QUICKBOOKS_API_HOST=sandbox-quickbooks.api.intuit.com in your .env for a sandbox company).
Provider notes
- The token endpoint authenticates with HTTP Basic (client_id:client_secret base64-encoded)
- Access tokens last 60 minutes; refresh tokens roll and remain valid for up to 100 days
- The company realm ID arrives as a query parameter on the OAuth callback, not in the token response; it must be saved and passed to every tool
- QuickBooks responds with XML unless the Accept: application/json header is sent (the tools set it by default)
- Sandbox companies use the sandbox-quickbooks.api.intuit.com host
Tools
Verify the connection
Call a read tool such as quickbooks__list_invoices with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.