Summary
Connects to QuickBooks Online's API with a focus on financial professionals rather than developers exploring the API. Resolves vendor and account names automatically instead of requiring internal IDs, includes built-in tools for P&L, Balance Sheet, and Trial Balance reports, and defaults all write operations to draft mode so you see changes before they hit your books. Uses a single SQL-like query tool across all QuickBooks entities instead of separate search endpoints for each type. Handles OAuth token refresh automatically and supports both local credential storage and AWS Secrets Manager for shared environments. Ships via npm and designed for bookkeepers and CFOs who want to pull reports or create journal entries through an AI assistant using plain language.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
18 tools
QUICKBOOKS_CREATE_ACCOUNTCreate a new account in QuickBooks with the given parameters.4 params
Create a new account in QuickBooks with the given parameters.
Parameters* required
namestringUser recognizable name for the Account. Account.Name attribute must not contain double quotes (") or colon (:).
account_typestringType of the account to be createdone of
Bank · Other Current Asset · Fixed Asset · Other Asset · Accounts Receivable · Equityaccount_numberstringUser-defined account number to help the user in identifying the account within the chart-of-accounts and in deciding what should be posted to the account. must not contain colon (:). For France locales:
account_sub_typestringSub-type of the account. Must use exact enum values (no spaces/slashes). Examples: 'AdvertisingPromotional' (NOT 'Advertising/Promotional'), 'Checking', 'Inventory', 'OtherCurrentAssets', 'Vehicles', 'RetainedEarnings', 'Insurance', 'InterestEarned'. See QuickBooks API docs for complete list.one of
CashOnHand · Checking · MoneyMarket · RentsHeldInTrust · Savings · TrustAccountsQUICKBOOKS_CREATE_CUSTOMERCreate a new customer in QuickBooks with the given parameters.6 params
Create a new customer in QuickBooks with the given parameters.
Parameters* required
titlestringTitle of the person (max 16 characters - keep it short like 'Mr.', 'Dr.', 'CEO'). This tag supports i18n, all locales. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, Suffix, or FullyQualifiedName attributes are required during create.
suffixstringSuffix of the name. For example, Jr. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, or Suffix attributes is required for object create.
given_namestringGiven name or first name of a person. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, or Suffix attributes is required for object create.
family_namestringFamily name or the last name of the person. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, or Suffix attributes is required for object create.
middle_namestringMiddle name of the person. The person can have zero or more middle names. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, or Suffix attributes is required for object create.
display_namestringThe name as displayed. Must be unique across all Customer, Vendor, and Employee objects. Cannot be removed with sparse update. If not supplied, the system generates DisplayName by concatenating customer name components supplied in the request from the following list: Title, GivenName, MiddleName, FamilyName, and Suffix.
QUICKBOOKS_CREATE_EMPLOYEECreate a new employee in QuickBooks.3 params
Create a new employee in QuickBooks.
Parameters* required
given_namestringGiven name or Family name of a person. At least one of `given_name` or `family_name` attributes is required.
family_namestringFamily name or the last name of the person. At least one of `given_name` or `family_name` attributes is required.
primary_addrobjectRepresents the physical street address for this employee. If QuickBooks Payroll is enabled for the company, the following PhysicalAddress fields are required: City, CountrySubDivisionCode, PostalCode.
QUICKBOOKS_CREATE_INVOICETool to create a new invoice in QuickBooks. Use after confirming customer and item details.3 params
Tool to create a new invoice in QuickBooks. Use after confirming customer and item details.
Parameters* required
linesarrayList of invoice line item objects. Each item must include at least: 'DetailType', 'Amount', and 'SalesItemLineDetail' with an 'ItemRef.value'.
customer_idstringID of the customer to invoice (CustomerRef.value)
minorversionintegerOptional minorversion query parameter to control API behavior
QUICKBOOKS_CREATE_VENDORCreate a new vendor in QuickBooks with the given details.6 params
Create a new vendor in QuickBooks with the given details.
Parameters* required
titlestringTitle of the person (max 16 characters - keep it short like 'Mr.', 'Dr.', 'CEO'). This tag supports i18n, all locales. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, Suffix, or FullyQualifiedName attributes are required during create.
suffixstringSuffix of the name. For example, Jr. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, or Suffix attributes is required for object create.
given_namestringGiven name or first name of a person. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, or Suffix attributes is required for object create.
family_namestringFamily name or the last name of the person. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, or Suffix attributes is required for object create.
middle_namestringMiddle name of the person. The person can have zero or more middle names. The DisplayName attribute or at least one of Title, GivenName, MiddleName, FamilyName, or Suffix attributes is required for object create.
display_namestringThe name as displayed. Must be unique across all Customer, Vendor, and Employee objects. Cannot be removed with sparse update. If not supplied, the system generates DisplayName by concatenating customer name components supplied in the request from the following list: Title, GivenName, MiddleName, FamilyName, and Suffix.
QUICKBOOKS_CUSTOMER_BALANCE_DETAILGenerate a balance detail report for a customer in QuickBooks with the given customer ID.13 params
Generate a balance detail report for a customer in QuickBooks with the given customer ID.
Parameters* required
arpaidstringStatus of the balance.one of
All · Paid · UnpaidcolumnsstringColumn types to be shown in the report. Supported Values: bill_addr, create_by, create_date, cust_bill_email, cust_comp_name, cust_msg, cust_phone_other, cust_tel, cust_name, deliv_addr, doc_num*, due_date*, last_mod_by, last_mod_date, memo*, sale_sent_state, ship_addr, ship_date, ship_via, term_name, tracking_num, tx_date*, txn_type*. Additional columns with custom fields enabled: sales_cust1, sales_cust2, sales_cust3. Additional columns with location tracking enabled: dept_name*
custom1stringFilter by the specified custom field as defined by the CustomField attribute in transaction entities where supported. Supported Values: Name of custom field.
shipviastringFilter by the shipping method as stored in Invoice.ShipMethodRef.Name.
sort_bystringThe column type used in sorting report rows. Specify a column type as defined with the columns query parameter.
term_idsarrayOne or more comma separated term IDs. Filters report contents based on term or terms supplied.
sort_orderstringThe sort order.one of
ascend · descendend_duedatestringThe range of dates over which receivables are due, in the format YYYY-MM-DD. start_duedate must be less than end_duedate. If not specified, all data is returned.
report_datestringStart date to use for the report, in the format YYYY-MM-DD.
aging_methodstringThe date upon which aging is determined.one of
Report_Date · Currentcustomer_idsarrayOne or more comma separated customer IDs. Filters report contents to include information for specified customers.
start_duedatestringThe range of dates over which receivables are due, in the format YYYY-MM-DD. start_duedate must be less than end_duedate. If not specified, all data is returned.
department_idsarrayOne or more comma separated department IDs. Filters report contents to include information for specified departments if so configured in the company file.
QUICKBOOKS_CUSTOMER_BALANCE_REPORTGenerate a balance report for a customer in QuickBooks with the given customer ID.8 params
Generate a balance report for a customer in QuickBooks with the given customer ID.
Parameters* required
arpaidstringSupported Values: All, Paid, Unpaidone of
All · Paid · Unpaiddate_macrostringPredefined date range. Use if you want the report to cover a standard report date range; otherwise, use the start_date and end_date to cover an explicit report date range.one of
Today · Yesterday · This Week · Last Week · This Week-to-date · Last Week-to-datesort_orderstringThe sort order.one of
ascend · descendreport_datestringStart date to use for the report, in the format YYYY-MM-DD.
customer_idsarrayFilters report contents to include information for specified customers. Supported Values: One or more comma separated customer IDs as returned in the attribute, Customer.Id, of the Customer object response code.
department_idsarrayOne or more comma separated department IDs. Filters report contents to include information for specified departments if so configured in the company file.
accounting_methodstringThe accounting method used in the report. one of
Cash · Accrualsummarize_column_bystringThe criteria by which to group the report results.one of
Total · Month · Week · Days · Quarter · YearQUICKBOOKS_LIST_INVOICESTool to list invoices via QuickBooks Query endpoint. Use when retrieving invoices with optional pagination and custom fields.3 params
Tool to list invoices via QuickBooks Query endpoint. Use when retrieving invoices with optional pagination and custom fields.
Parameters* required
fieldsarrayList of fields to select in the query. Defaults to ['Id','SyncToken','DocNumber','TotalAmt','Balance','TxnDate'].
max_resultsintegerMaximum number of records to return; default 50, max 1000.default: 50
start_positionintegerStarting position for pagination within the result set. Default is 1.default: 1
QUICKBOOKS_QUERY_ACCOUNTQuery an account in QuickBooks with the given parameters.1 params
Query an account in QuickBooks with the given parameters.
Parameters* required
querystringQuery to be executed
QUICKBOOKS_READ_ACCOUNTRead an account in QuickBooks with the given account ID.1 params
Read an account in QuickBooks with the given account ID.
Parameters* required
account_idstringID of the account to be read
QUICKBOOKS_READ_CUSTOMERRead a customer in QuickBooks with the given customer ID.1 params
Read a customer in QuickBooks with the given customer ID.
Parameters* required
customer_idstringID of the customer to be read
QUICKBOOKS_READ_EMPLOYEERead an employee's details in QuickBooks with the given employee ID.1 params
Read an employee's details in QuickBooks with the given employee ID.
Parameters* required
employee_idstringThe ID of the employee to be read.
QUICKBOOKS_READ_INVOICETool to fetch a QuickBooks invoice by ID or the most recent if no ID provided. Use when needing full invoice details including metadata and sync token.2 params
Tool to fetch a QuickBooks invoice by ID or the most recent if no ID provided. Use when needing full invoice details including metadata and sync token.
Parameters* required
invoice_idstringID of the invoice to read; if not provided, fetches the latest invoice
minorversionintegerAPI minor version to use for the request
QUICKBOOKS_READ_VENDORRead a vendor in QuickBooks with the given vendor ID.1 params
Read a vendor in QuickBooks with the given vendor ID.
Parameters* required
vendor_idstringID of the vendor to be read
QUICKBOOKS_UPDATE_FULL_INVOICETool to fully replace an Invoice. Use when you need to update all aspects of an existing invoice in a single operation.3 params
Tool to fully replace an Invoice. Use when you need to update all aspects of an existing invoice in a single operation.
Parameters* required
invoiceobjectFull Invoice JSON payload to update; must include Id and SyncToken. Any writable field omitted will be cleared. Do not set sparse=true.
requestidstringOptional idempotency key (<=50 chars) to prevent duplicate writes on retries.
minorversionintegerOptional QuickBooks API minorversion to access newer fields (e.g., 63).
QUICKBOOKS_UPDATE_SPARSE_INVOICETool to perform a sparse update of an existing invoice. Use when you need to update only specific invoice fields without overwriting other data.1 params
Tool to perform a sparse update of an existing invoice. Use when you need to update only specific invoice fields without overwriting other data.
Parameters* required
invoiceobjectInvoice object containing Id, SyncToken, sparse flag, and fields to update
QUICKBOOKS_VENDOR_BALANCE_DETAILGenerate a balance detail report for a vendor in QuickBooks with the given vendor ID.12 params
Generate a balance detail report for a vendor in QuickBooks with the given vendor ID.
Parameters* required
appaidstringStatus of the balance.one of
All · Paid · Unpaidsort_bystringThe column type used in sorting report rows. Specify a column type as defined with the columns query parameter.
term_idsarrayOne or more comma separated term IDs. Filters report contents based on term or terms supplied.
date_macrostringPredefined date range. Use if you want the report to cover a standard report date range; otherwise, use the start_date and end_date to cover an explicit report date range.one of
Today · Yesterday · This Week · Last Week · This Week-to-date · Last Week-to-datesort_orderstringThe sort order.one of
ascend · descendvendor_idsarrayOne or more comma separated vendor IDs. Filters report contents to include information for specified vendors.
end_duedatestringThe range of dates over which receivables are due, in the format YYYY-MM-DD. start_duedate must be less than end_duedate. If not specified, all data is returned.
report_datestringStart date to use for the report, in the format YYYY-MM-DD.
duedate_macrostringPredefined date range of due dates for balances to include in the report; otherwise, use the start_duedate and end_duedate to cover an explicit report date range. one of
Today · Yesterday · This Week · Last Week · This Week-to-date · Last Week-to-datestart_duedatestringThe range of dates over which receivables are due, in the format YYYY-MM-DD. start_duedate must be less than end_duedate. If not specified, all data is returned.
department_idsarrayOne or more comma separated department IDs. Filters report contents to include information for specified departments if so configured in the company file.
accounting_methodstringThe accounting method used in the report.one of
Cash · AccrualQUICKBOOKS_VENDOR_BALANCE_REPORTGet the balance report of a vendor in QuickBooks with the given vendor ID.9 params
Get the balance report of a vendor in QuickBooks with the given vendor ID.
Parameters* required
qzurlstringSpecifies whether Quick Zoom URL information should be generated for rows in the report.
appaidstringStatus of the balance.one of
All · Paid · Unpaiddate_macrostringPredefined date range. Use if you want the report to cover a standard report date range; otherwise, use the start_date and end_date to cover an explicit report date range.one of
Today · Yesterday · This Week · Last Week · This Week-to-date · Last Week-to-datesort_orderstringThe sort order.one of
ascend · descendvendor_idsarrayFilters report contents to include information for specified vendors. Supported Values: One or more comma separated vendor IDs as returned in the attribute, Vendor.Id, of the Vendor object response code.
report_datestringStart date to use for the report, in the format YYYY-MM-DD.
department_idsarrayOne or more comma separated department IDs. Filters report contents to include information for specified departments if so configured in the company file.
accounting_methodstringThe accounting method used in the report. one of
Cash · Accrualsummarize_column_bystringThe criteria by which to group the report results.one of
Total · Month · Week · Days · Quarter · YearQuickBooks MCP Server
An MCP server for QuickBooks Online — built for bookkeepers, CFOs, and accountants who use AI assistants in their daily workflow.
Ask your AI assistant to pull a P&L report, create a journal entry, or investigate an account balance — using plain language, not API payloads.
Why This Server?
Intuit provides an official MCP server that's a solid starting point for developers exploring the QuickBooks API. This server takes a different approach: it's designed for financial professionals working in production books.
Use natural language, not internal IDs
Intuit's server requires QuickBooks internal IDs for every reference — you need to look up a vendor's ID before creating a bill. This server resolves names automatically:
"Create a bill for PG&E, $450 to Utilities, dated 2025-01-15"
→ Vendor, account, and department names are resolved automatically
Financial reports built in
This is the only QuickBooks MCP server with report tools. Pull a P&L, Balance Sheet, or Trial Balance — broken down by month, department, or class — without leaving your AI conversation.
Safe by default
Every create and edit operation defaults to draft/preview mode. You see exactly what will be written to your books before committing. No accidental journal entries or misclassified expenses.
One query tool instead of dozens
Instead of separate search tools for each entity type, a single SQL-like query tool works across all QuickBooks entities. AI assistants write SQL naturally, and QuickBooks validates it — no field whitelists to maintain.
"SELECT * FROM Purchase WHERE TxnDate >= '2025-01-01' AND TxnDate <= '2025-01-31'"
Production-ready credential management
Store credentials locally for personal use, or in AWS Secrets Manager for shared environments. OAuth tokens refresh automatically and persist across sessions.
At a glance
| Intuit Official | This Server | |
|---|---|---|
| Audience | Developers exploring the API | Bookkeepers, CFOs, accountants |
| Name resolution | Requires internal QB IDs | Resolves names automatically |
| Financial reports | None | P&L, Balance Sheet, Trial Balance |
| Write safety | Executes immediately | Draft preview by default |
| Query approach | Entity-specific search tools | SQL-like queries across all entities |
| Credentials | Local .env file | Local file or AWS Secrets Manager |
| Distribution | Clone from GitHub | npx quickbooks-mcp |
Prerequisites
- QuickBooks Developer Account: Register at developer.intuit.com
- Node.js 18+
Installation Options
Choose the setup that fits your use case:
| Setup | Best For |
|---|---|
| NPM Install | Quick setup, using your own QuickBooks app |
| Local Checkout | Development, customization |
| AWS Mode | Shared/production environments |
Option 1: NPM Install
The simplest way to get started. Credentials are stored locally on your machine.
1. Create a QuickBooks App
- Go to developer.intuit.com and sign in
- Create a new app (or select an existing one)
- Go to "Keys & credentials"
- Note your Client ID and Client Secret
- Under "Redirect URIs", add:
https://developer.intuit.com/v2/OAuth2Playground/RedirectUrl
2. Add to Claude Code
Add to your project's .mcp.json:
{
"mcpServers": {
"quickbooks": {
"command": "npx",
"args": ["-y", "quickbooks-mcp"]
}
}
}
3. Configure Credentials
Create ~/.quickbooks-mcp/credentials.json:
{
"client_id": "your_client_id",
"client_secret": "your_client_secret"
}
4. Authenticate
Once Claude Code is running, use the qbo_authenticate tool:
- Call
qbo_authenticatewith no arguments to get an authorization URL - Open the URL in your browser and authorize the app
- Copy the
codeandrealmIdfrom the redirect URL - Call
qbo_authenticateagain with the authorization code and realm ID
Your OAuth tokens will be saved and automatically refreshed.
Option 2: Local Checkout
For development or customization.
1. Create a QuickBooks App
Follow the same steps as Option 1 above.
2. Clone and Build
git clone https://github.com/laf-rge/quickbooks-mcp.git
cd quickbooks-mcp
npm install
npm run build
3. Add to Claude Code
Add to your project's .mcp.json:
{
"mcpServers": {
"quickbooks": {
"command": "node",
"args": ["/path/to/quickbooks-mcp/dist/index.js"]
}
}
}
4. Configure Credentials
Create ~/.quickbooks-mcp/credentials.json with your client credentials (same as Option 1), then run qbo_authenticate to complete the OAuth flow.
Option 3: AWS Mode
For shared or production environments. Stores credentials in AWS Secrets Manager.
1. Create AWS Resources
Create the secret in Secrets Manager:
aws secretsmanager create-secret \
--name prod/qbo \
--secret-string '{
"client_id": "your_client_id",
"client_secret": "your_client_secret",
"access_token": "your_access_token",
"refresh_token": "your_refresh_token",
"redirect_url": "https://developer.intuit.com/v2/OAuth2Playground/RedirectUrl"
}'
Store Company ID in SSM Parameter Store:
aws ssm put-parameter \
--name /prod/qbo/company_id \
--value "your_company_id" \
--type SecureString
2. Configure the Server
Create a .env file in the quickbooks-mcp directory:
QBO_CREDENTIAL_MODE=aws
AWS_REGION=us-east-2
QBO_SECRET_NAME=prod/qbo
QBO_COMPANY_ID_PARAM=/prod/qbo/company_id
Note: Due to a known Claude Code bug, environment variables from
.mcp.jsonare not reliably passed to MCP servers. The.envfile workaround is required.
3. Add to Claude Code
{
"mcpServers": {
"quickbooks": {
"command": "node",
"args": ["/path/to/quickbooks-mcp/dist/index.js"]
}
}
}
4. IAM Permissions
The server needs these AWS permissions:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue"
],
"Resource": "arn:aws:secretsmanager:*:*:secret:prod/qbo*"
},
{
"Effect": "Allow",
"Action": ["ssm:GetParameter"],
"Resource": "arn:aws:ssm:*:*:parameter/prod/qbo/*"
}
]
}
Inline Output Mode
By default, large responses (reports, query results) are written to /tmp files and the server returns a file path. This works well for Claude Code in terminal environments but breaks in Claude Desktop and plugin environments where the model cannot read from /tmp.
Set QBO_INLINE_OUTPUT=true to return all responses inline instead.
Option A — via .env file (recommended for local checkout):
Create a .env file in the quickbooks-mcp directory:
QBO_INLINE_OUTPUT=true
Option B — via .mcp.json env block (recommended for NPM install):
{
"mcpServers": {
"quickbooks": {
"command": "npx",
"args": ["-y", "quickbooks-mcp"],
"env": {
"QBO_CREDENTIAL_MODE": "local",
"QBO_CREDENTIAL_FILE": "~/.quickbooks-mcp/credentials.json",
"QBO_INLINE_OUTPUT": "true"
}
}
}
}
Note: Due to a known Claude Code bug, environment variables from
.mcp.jsonare not reliably passed to MCP servers in some configurations. If Option B doesn't work, use the.envfile workaround.
Environment Variables
| Variable | Default | Description |
|---|---|---|
QBO_CREDENTIAL_MODE | local | Credential storage: local or aws |
QBO_CLIENT_ID | - | QuickBooks app Client ID (local mode) |
QBO_CLIENT_SECRET | - | QuickBooks app Client Secret (local mode) |
QBO_CREDENTIAL_FILE | ~/.quickbooks-mcp/credentials.json | Custom credential file path |
QBO_INLINE_OUTPUT | false | Return responses inline instead of writing to /tmp files. Required when using Claude Desktop or plugin environments where file-based output is not accessible to the model. |
QBO_SANDBOX | false | Use QuickBooks sandbox environment |
AWS_REGION | us-east-2 | AWS region (aws mode) |
QBO_SECRET_NAME | prod/qbo | Secrets Manager secret name (aws mode) |
QBO_COMPANY_ID_PARAM | /prod/qbo/company_id | SSM parameter path (aws mode) |
Available Tools
| Tool | Description |
|---|---|
| Setup | |
qbo_authenticate | Set up OAuth credentials (local mode only) |
get_company_info | Get connected company information |
| Query & Reports | |
query | Run SQL-like queries against any QuickBooks entity |
list_accounts | List chart of accounts with filtering |
get_profit_loss | Profit & Loss report (by month, department, class, etc.) |
get_balance_sheet | Balance Sheet report |
get_trial_balance | Trial Balance report |
query_account_transactions | All transactions affecting a specific account |
account_period_summary | Period summary for an account (opening/closing balance, debits, credits, count) |
| Journal Entries | |
create_journal_entry | Create a journal entry (validates debits = credits) |
get_journal_entry | Fetch a journal entry by ID |
edit_journal_entry | Modify an existing journal entry |
| Bills | |
create_bill | Create a vendor bill |
get_bill | Fetch a bill by ID |
edit_bill | Modify an existing bill |
| Expenses | |
create_expense | Create an expense (Cash, Check, or Credit Card) |
get_expense | Fetch an expense by ID |
edit_expense | Modify an existing expense |
| Sales Receipts | |
create_sales_receipt | Create a sales receipt with item lines |
get_sales_receipt | Fetch a sales receipt by ID |
edit_sales_receipt | Modify an existing sales receipt |
| Invoices | |
create_invoice | Create an invoice with item lines (customer required) |
get_invoice | Fetch an invoice by ID |
edit_invoice | Modify an existing invoice |
| Deposits | |
create_deposit | Create a bank deposit |
get_deposit | Fetch a deposit by ID |
edit_deposit | Modify an existing deposit |
| Vendor Credits | |
create_vendor_credit | Create a vendor credit |
get_vendor_credit | Fetch a vendor credit by ID |
edit_vendor_credit | Modify an existing vendor credit |
| Bill Payments | |
create_bill_payment | Pay bills and apply vendor credits (the QBO "check" / pay-bills flow) |
get_bill_payment | Fetch a bill payment by ID; flags unapplied amounts |
| Delete | |
delete_entity | Delete any transaction (journal entry, bill, invoice, deposit, sales receipt, expense, vendor credit, bill payment) |
Token Refresh
The server automatically refreshes OAuth tokens on each request and persists them back to your credential store (local file or AWS Secrets Manager).
Development
npm run dev # Run in development mode
npm run build # Build
npm run typecheck # Type check
Troubleshooting
"QuickBooks credentials not configured"
Run the qbo_authenticate tool to set up OAuth credentials (local mode only).
"Authorization code expired"
Authorization codes are only valid for a few minutes. Start the OAuth flow again.
Token refresh fails
- Check that your refresh token hasn't expired (~100 days)
- Verify your client credentials are correct
- Try re-authenticating with
qbo_authenticate
AWS credential errors
- Ensure
.envfile hasQBO_CREDENTIAL_MODE=aws - Check your AWS credentials and permissions
- Verify the secret and parameter names match your configuration
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
QBO_CLIENT_IDsecretQuickBooks app Client ID from developer.intuit.com
QBO_CLIENT_SECRETsecretQuickBooks app Client Secret from developer.intuit.com
QBO_CREDENTIAL_MODECredential storage mode: 'local' (default) or 'aws'
QBO_SANDBOXSet to 'true' to use QuickBooks sandbox environment
Categories
Registryactive
Packagequickbooks-mcp
TransportSTDIO
AuthRequired
UpdatedJun 3, 2026
