QuickBooks Online

OCI · GHCR.IO/WYRE-AI/QBO-MCP

MCP server for QuickBooks Online — accounts, customers, invoices, bills, and reports.

Available components

oci · ghcr.io/wyre-ai/qbo-mcp 42

42 42 Trust /100

Last scanned 17 Oct 2026 (1 hour ago)

Scores higher than 59% of OCI servers

Category Finance and Payments

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security0

No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.Unverified
Known CVEs could not be checked: this artifact ships no SBOM or dependency manifest, so there is no dependency list to read.Unverified
Install-script risk not yet assessed.Unverified
Dependency health could not be checked: this artifact ships no SBOM or dependency manifest, so there is no dependency list to read.Unverified

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (Apache-2.0).Pass
Actively maintained (last published 2 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability84

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 16862 tokens (~121/item across 139 items; 138 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management7

Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Tool Safety75

No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
0 of 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "qbo_invoices_send" implies "send" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
An AI judge read all 139 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Supports UI / widget rendering.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

17 Oct 26 +1
- Stability: unverified → 0.07 ▲ functional
15 Oct 26 +32
- Injection markers: unverified → pass ▲ security
- First check of Judged manipulation: pass security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- First check of Schema quality: fail functional
- First check of Schema quality: excellent functional
- First check of Schema quality: fail functional
- First check of Capabilities: pass functional
- First check of Destructive annotations: 0 functional
- First check of Tool coverage: 100 functional
14 Oct 26 9

First indexed and scored.

Show 1 earlier entry Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 17 Oct 2026 · Analysed oci/ghcr.io/wyre-ai/qbo-mcp@v1.6.6

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	oci
Reason	No attestation published

Background: How many MCP packages publish verified provenance →

MCP tools · 138 exposed · ~16,844 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens

qbo_accounts_create ~195

Create a new Account record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
AccountSubType	string	–	Specific sub-type within the AccountType, e.g. Checking, SalesOfProductIncome
AccountType	string	–	High-level account type, e.g. Bank, Accounts Receivable, Income, Expense, Equity, Other Current Asset (required on create)
AcctNum	string	–	User-defined account number (if chart-of-accounts numbering is enabled)
Active	boolean	–	Whether the account is active (inactive accounts are hidden)
CurrencyRef	object	–	Currency reference for multi-currency companies, e.g. {"value": "USD"}
Description	string	–	Free-form description
Name	string	yes	Account name (required, must be unique within parent)
ParentRef	object	–	Parent account reference for sub-accounts, e.g. {"value": "42"}

No output schema declared.

No examples provided.

qbo_accounts_get ~31

Get a specific Account record by its ID.

Input Output Examples

Name	Type	Req	Description
accountId	string	yes	The unique Account ID

No output schema declared.

No examples provided.

qbo_accounts_list ~65

List Account records in QuickBooks Online with pagination.

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_accounts_search ~96

Search Account records by Name (LIKE match).

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)
term	string	yes	Search term matched against Name with LIKE '%term%'. '%' is a wildcard; QBO does not support an ESCAPE clause.

No output schema declared.

No examples provided.

qbo_accounts_update ~248

Sparse-update an existing Account record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
AccountSubType	string	–	Specific sub-type within the AccountType, e.g. Checking, SalesOfProductIncome
AccountType	string	–	High-level account type, e.g. Bank, Accounts Receivable, Income, Expense, Equity, Other Current Asset (required on create)
AcctNum	string	–	User-defined account number (if chart-of-accounts numbering is enabled)
Active	boolean	–	Whether the account is active (inactive accounts are hidden)
CurrencyRef	object	–	Currency reference for multi-currency companies, e.g. {"value": "USD"}
Description	string	–	Free-form description
Name	string	yes	Account name (required, must be unique within parent)
ParentRef	object	–	Parent account reference for sub-accounts, e.g. {"value": "42"}
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
accountId	string	yes	The Account ID to update

No output schema declared.

No examples provided.

qbo_attachables_create ~124

Create a new Attachable record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
AttachableRef	array	–	Array of references attaching this to one or more transactions: [{EntityRef: {value, type}, IncludeOnSend: boolean}].
Category	string	–	User-defined category
ContentType	string	–	MIME type, e.g. "application/pdf"
FileAccessUri	string	–	URI for accessing the file
FileName	string	–	Original filename
Note	string	–	Free-form text note (instead of a file)

No output schema declared.

No examples provided.

qbo_attachables_get ~35

Get a specific Attachable record by its ID.

Input Output Examples

Name	Type	Req	Description
attachableId	string	yes	The unique Attachable ID

No output schema declared.

No examples provided.

qbo_attachables_list ~67

List Attachable records in QuickBooks Online with pagination.

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_attachables_update ~179

Sparse-update an existing Attachable record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
AttachableRef	array	–	Array of references attaching this to one or more transactions: [{EntityRef: {value, type}, IncludeOnSend: boolean}].
Category	string	–	User-defined category
ContentType	string	–	MIME type, e.g. "application/pdf"
FileAccessUri	string	–	URI for accessing the file
FileName	string	–	Original filename
Note	string	–	Free-form text note (instead of a file)
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
attachableId	string	yes	The Attachable ID to update

No output schema declared.

No examples provided.

qbo_attachables_upload ~246

Upload a file to QuickBooks Online and (optionally) attach it to a transaction. Returns the created Attachable record. File bytes must be provided base64-encoded; QBO's max attachment size is 100 MB per file.

Input Output Examples

Name	Type	Req	Description
attachToId	string	–	Optional QBO entity ID to attach this file to
attachToType	string	–	Optional QBO entity type to attach this file to, e.g. "Invoice", "Bill", "Customer"
base64Data	string	yes	Base64-encoded file content
category	string	–	Optional user-defined category, e.g. "Receipt", "Contract"
contentType	string	yes	MIME type of the file, e.g. "application/pdf" or "image/png"
fileName	string	yes	Original filename including extension, e.g. "invoice-1234.pdf"
includeOnSend	boolean	–	Optional. When true and attached to a sendable entity (Invoice, Estimate), include this file when the entity is sent by email. Defaults to false.
note	string	–	Optional free-form note stored on the Attachable

No output schema declared.

No examples provided.

qbo_bill_payments_create ~229

Create a new BillPayment record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
CheckPayment	object	–	Required when PayType is "Check". Shape: {BankAccountRef: {value}, PrintStatus: "NeedToPrint"\|"PrintComplete"}
CreditCardPayment	object	–	Required when PayType is "CreditCard". Shape: {CCAccountRef: {value}}
DocNumber	string	–	Reference number (e.g. check number)
Line	array	yes	Array of LinkedTxn entries: [{Amount, LinkedTxn: [{TxnId: "billId", TxnType: "Bill"}]}].
PayType	string	yes	Payment method: "Check" or "CreditCard" (required)
PrivateNote	string	–	Private note
TotalAmt	number	yes	Total payment amount across all linked bills (required)
TxnDate	string	–	Payment date (YYYY-MM-DD); defaults to today if omitted
VendorRef	object	yes	Vendor reference, e.g. {"value": "56"} (required)

No output schema declared.

No examples provided.

qbo_bill_payments_get ~36

Get a specific BillPayment record by its ID.

Input Output Examples

Name	Type	Req	Description
billPaymentId	string	yes	The unique BillPayment ID

No output schema declared.

No examples provided.

qbo_bill_payments_list ~118

List BillPayment records in QuickBooks Online with pagination and optional TxnDate range.

Input Output Examples

Name	Type	Req	Description
endDate	string	–	Filter to records on or before this TxnDate (YYYY-MM-DD)
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startDate	string	–	Filter to records on or after this TxnDate (YYYY-MM-DD)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_bill_payments_update ~284

Sparse-update an existing BillPayment record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
CheckPayment	object	–	Required when PayType is "Check". Shape: {BankAccountRef: {value}, PrintStatus: "NeedToPrint"\|"PrintComplete"}
CreditCardPayment	object	–	Required when PayType is "CreditCard". Shape: {CCAccountRef: {value}}
DocNumber	string	–	Reference number (e.g. check number)
Line	array	yes	Array of LinkedTxn entries: [{Amount, LinkedTxn: [{TxnId: "billId", TxnType: "Bill"}]}].
PayType	string	yes	Payment method: "Check" or "CreditCard" (required)
PrivateNote	string	–	Private note
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
TotalAmt	number	yes	Total payment amount across all linked bills (required)
TxnDate	string	–	Payment date (YYYY-MM-DD); defaults to today if omitted
VendorRef	object	yes	Vendor reference, e.g. {"value": "56"} (required)
billPaymentId	string	yes	The BillPayment ID to update

No output schema declared.

No examples provided.

qbo_bills_create ~199

Create a new Bill record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
APAccountRef	object	–	Accounts Payable account reference, e.g. {"value": "33"}
DocNumber	string	–	Reference number / bill number from the vendor
DueDate	string	–	Due date (YYYY-MM-DD)
Line	array	yes	Array of bill lines. Each line: {Amount, DetailType: "AccountBasedExpenseLineDetail" \| "ItemBasedExpenseLineDetail", AccountBasedExpenseLineDetail?: {AccountRef: {value}}, ItemBasedExpenseLineDetail?…
PrivateNote	string	–	Private note (not visible to vendor)
TxnDate	string	–	Bill date (YYYY-MM-DD); defaults to today if omitted
VendorRef	object	yes	Vendor reference, e.g. {"value": "56"} (required)

No output schema declared.

No examples provided.

qbo_bills_get ~32

Get a specific Bill record by its ID.

Input Output Examples

Name	Type	Req	Description
billId	string	yes	The unique Bill ID

No output schema declared.

No examples provided.

qbo_bills_list ~116

List Bill records in QuickBooks Online with pagination and optional TxnDate range.

Input Output Examples

Name	Type	Req	Description
endDate	string	–	Filter to records on or before this TxnDate (YYYY-MM-DD)
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startDate	string	–	Filter to records on or after this TxnDate (YYYY-MM-DD)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_bills_search ~99

Search Bill records by DocNumber (LIKE match).

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)
term	string	yes	Search term matched against DocNumber with LIKE '%term%'. '%' is a wildcard; QBO does not support an ESCAPE clause.

No output schema declared.

No examples provided.

qbo_bills_update ~252

Sparse-update an existing Bill record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
APAccountRef	object	–	Accounts Payable account reference, e.g. {"value": "33"}
DocNumber	string	–	Reference number / bill number from the vendor
DueDate	string	–	Due date (YYYY-MM-DD)
Line	array	yes	Array of bill lines. Each line: {Amount, DetailType: "AccountBasedExpenseLineDetail" \| "ItemBasedExpenseLineDetail", AccountBasedExpenseLineDetail?: {AccountRef: {value}}, ItemBasedExpenseLineDetail?…
PrivateNote	string	–	Private note (not visible to vendor)
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
TxnDate	string	–	Bill date (YYYY-MM-DD); defaults to today if omitted
VendorRef	object	yes	Vendor reference, e.g. {"value": "56"} (required)
billId	string	yes	The Bill ID to update

No output schema declared.

No examples provided.

qbo_classes_create ~72

Create a new Class record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
Active	boolean	–	Whether the class is active
Name	string	yes	Class name (required, must be unique within parent)
ParentRef	object	–	Parent class for sub-classes, e.g. {"value": "3"}

No output schema declared.

No examples provided.

qbo_classes_get ~31

Get a specific Class record by its ID.

Input Output Examples

Name	Type	Req	Description
classId	string	yes	The unique Class ID

No output schema declared.

No examples provided.

qbo_classes_list ~65

List Class records in QuickBooks Online with pagination.

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_classes_search ~96

Search Class records by Name (LIKE match).

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)
term	string	yes	Search term matched against Name with LIKE '%term%'. '%' is a wildcard; QBO does not support an ESCAPE clause.

No output schema declared.

No examples provided.

qbo_classes_update ~125

Sparse-update an existing Class record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
Active	boolean	–	Whether the class is active
Name	string	yes	Class name (required, must be unique within parent)
ParentRef	object	–	Parent class for sub-classes, e.g. {"value": "3"}
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
classId	string	yes	The Class ID to update

No output schema declared.

No examples provided.

qbo_company_info_get ~35

Get a specific CompanyInfo record by its ID.

Input Output Examples

Name	Type	Req	Description
companyInfoId	string	yes	The unique CompanyInfo ID

No output schema declared.

No examples provided.

qbo_company_info_list ~67

List CompanyInfo records in QuickBooks Online with pagination.

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_credit_memos_create ~162

Create a new CreditMemo record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
BillEmail	object	–	Customer email, e.g. {"Address": "customer@example.com"}
CustomerMemo	object	–	Memo visible to customer, e.g. {"value": "Refund for damaged goods"}
CustomerRef	object	yes	Customer receiving the credit, e.g. {"value": "123"}
DocNumber	string	–	Credit memo number
Line	array	yes	Credit lines, same shape as Invoice.Line: {Amount, DetailType: "SalesItemLineDetail", SalesItemLineDetail: {ItemRef}}.
PrivateNote	string	–	Private note
TxnDate	string	–	Credit date (YYYY-MM-DD)

No output schema declared.

No examples provided.

qbo_credit_memos_get ~36

Get a specific CreditMemo record by its ID.

Input Output Examples

Name	Type	Req	Description
creditMemoId	string	yes	The unique CreditMemo ID

No output schema declared.

No examples provided.

qbo_credit_memos_list ~118

List CreditMemo records in QuickBooks Online with pagination and optional TxnDate range.

Input Output Examples

Name	Type	Req	Description
endDate	string	–	Filter to records on or before this TxnDate (YYYY-MM-DD)
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startDate	string	–	Filter to records on or after this TxnDate (YYYY-MM-DD)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_credit_memos_update ~217

Sparse-update an existing CreditMemo record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
BillEmail	object	–	Customer email, e.g. {"Address": "customer@example.com"}
CustomerMemo	object	–	Memo visible to customer, e.g. {"value": "Refund for damaged goods"}
CustomerRef	object	yes	Customer receiving the credit, e.g. {"value": "123"}
DocNumber	string	–	Credit memo number
Line	array	yes	Credit lines, same shape as Invoice.Line: {Amount, DetailType: "SalesItemLineDetail", SalesItemLineDetail: {ItemRef}}.
PrivateNote	string	–	Private note
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
TxnDate	string	–	Credit date (YYYY-MM-DD)
creditMemoId	string	yes	The CreditMemo ID to update

No output schema declared.

No examples provided.

qbo_customers_create ~149

Create a new Customer record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
BillAddr	object	–	Billing address object with Line1, City, CountrySubDivisionCode, PostalCode
CompanyName	string	–	Company name
DisplayName	string	yes	Display name for the customer (required, must be unique)
FamilyName	string	–	Last name of the customer
GivenName	string	–	First name of the customer
PrimaryEmailAddr	object	–	Primary email address object, e.g. {"Address": "user@example.com"}
PrimaryPhone	object	–	Primary phone object, e.g. {"FreeFormNumber": "555-1234"}

No output schema declared.

No examples provided.

qbo_customers_get ~32

Get a specific Customer record by its ID.

Input Output Examples

Name	Type	Req	Description
customerId	string	yes	The unique Customer ID

No output schema declared.

No examples provided.

qbo_customers_list ~66

List Customer records in QuickBooks Online with pagination.

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_customers_search ~99

Search Customer records by DisplayName (LIKE match).

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)
term	string	yes	Search term matched against DisplayName with LIKE '%term%'. '%' is a wildcard; QBO does not support an ESCAPE clause.

No output schema declared.

No examples provided.

qbo_customers_update ~228

Sparse-update an existing Customer record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
Active	boolean	–	Set to false to deactivate the customer. QuickBooks Online has no void or delete operation for Customer.
BillAddr	object	–	Billing address object with Line1, City, CountrySubDivisionCode, PostalCode
CompanyName	string	–	Company name
DisplayName	string	–	Display name for the customer (required, must be unique)
FamilyName	string	–	Last name of the customer
GivenName	string	–	First name of the customer
PrimaryEmailAddr	object	–	Primary email address object, e.g. {"Address": "user@example.com"}
PrimaryPhone	object	–	Primary phone object, e.g. {"FreeFormNumber": "555-1234"}
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
customerId	string	yes	The Customer ID to update

No output schema declared.

No examples provided.

qbo_departments_create ~65

Create a new Department record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
Active	boolean	–	Whether the department is active
Name	string	yes	Department name (required, must be unique within parent)
ParentRef	object	–	Parent department for sub-departments

No output schema declared.

No examples provided.

qbo_departments_get ~32

Get a specific Department record by its ID.

Input Output Examples

Name	Type	Req	Description
departmentId	string	yes	The unique Department ID

No output schema declared.

No examples provided.

qbo_departments_list ~66

List Department records in QuickBooks Online with pagination.

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_departments_search ~97

Search Department records by Name (LIKE match).

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)
term	string	yes	Search term matched against Name with LIKE '%term%'. '%' is a wildcard; QBO does not support an ESCAPE clause.

No output schema declared.

No examples provided.

qbo_departments_update ~118

Sparse-update an existing Department record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
Active	boolean	–	Whether the department is active
Name	string	yes	Department name (required, must be unique within parent)
ParentRef	object	–	Parent department for sub-departments
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
departmentId	string	yes	The Department ID to update

No output schema declared.

No examples provided.

qbo_deposits_create ~165

Create a new Deposit record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
CashBack	object	–	Optional cash-back amount: {Amount, AccountRef: {value}, Memo?}
DepositToAccountRef	object	yes	Bank account receiving the deposit, e.g. {"value": "35"}
DocNumber	string	–	Deposit reference number
Line	array	yes	Deposit lines. Each line is either {Amount, DetailType: "DepositLineDetail", DepositLineDetail: {AccountRef, Entity?, PaymentMethodRef?}} OR {Amount, LinkedTxn: [{TxnId, TxnType}]} for linked transac…
PrivateNote	string	–	Private note
TxnDate	string	–	Deposit date (YYYY-MM-DD)

No output schema declared.

No examples provided.

qbo_deposits_get ~33

Get a specific Deposit record by its ID.

Input Output Examples

Name	Type	Req	Description
depositId	string	yes	The unique Deposit ID

No output schema declared.

No examples provided.

qbo_deposits_list ~117

List Deposit records in QuickBooks Online with pagination and optional TxnDate range.

Input Output Examples

Name	Type	Req	Description
endDate	string	–	Filter to records on or before this TxnDate (YYYY-MM-DD)
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startDate	string	–	Filter to records on or after this TxnDate (YYYY-MM-DD)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_deposits_update ~218

Sparse-update an existing Deposit record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
CashBack	object	–	Optional cash-back amount: {Amount, AccountRef: {value}, Memo?}
DepositToAccountRef	object	yes	Bank account receiving the deposit, e.g. {"value": "35"}
DocNumber	string	–	Deposit reference number
Line	array	yes	Deposit lines. Each line is either {Amount, DetailType: "DepositLineDetail", DepositLineDetail: {AccountRef, Entity?, PaymentMethodRef?}} OR {Amount, LinkedTxn: [{TxnId, TxnType}]} for linked transac…
PrivateNote	string	–	Private note
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
TxnDate	string	–	Deposit date (YYYY-MM-DD)
depositId	string	yes	The Deposit ID to update

No output schema declared.

No examples provided.

qbo_employees_create ~220

Create a new Employee record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
Active	boolean	–	Whether the employee is active
BillableTime	boolean	–	Whether the employee's time is billable to customers
BirthDate	string	–	Birth date (YYYY-MM-DD)
DisplayName	string	yes	Display name (required, must be unique)
EmployeeNumber	string	–	Internal employee number
FamilyName	string	–	Last name
GivenName	string	–	First name
HiredDate	string	–	Hire date (YYYY-MM-DD)
MiddleName	string	–	Middle name
PrimaryAddr	object	–	Home address (Line1, City, CountrySubDivisionCode, PostalCode)
PrimaryEmailAddr	object	–	Email, e.g. {"Address": "employee@example.com"}
PrimaryPhone	object	–	Phone, e.g. {"FreeFormNumber": "555-1234"}
ReleasedDate	string	–	Termination date (YYYY-MM-DD)

No output schema declared.

No examples provided.

qbo_employees_get ~32

Get a specific Employee record by its ID.

Input Output Examples

Name	Type	Req	Description
employeeId	string	yes	The unique Employee ID

No output schema declared.

No examples provided.

qbo_employees_list ~66

List Employee records in QuickBooks Online with pagination.

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)

No output schema declared.

No examples provided.

qbo_employees_search ~99

Search Employee records by DisplayName (LIKE match).

Input Output Examples

Name	Type	Req	Description
maxResults	number	–	Maximum number of results to return (default: 100, max: 1000)
startPosition	number	–	Starting position for pagination (1-based, default: 1)
term	string	yes	Search term matched against DisplayName with LIKE '%term%'. '%' is a wildcard; QBO does not support an ESCAPE clause.

No output schema declared.

No examples provided.

qbo_employees_update ~273

Sparse-update an existing Employee record. Only provided fields are changed; Id and SyncToken are required.

Input Output Examples

Name	Type	Req	Description
Active	boolean	–	Whether the employee is active
BillableTime	boolean	–	Whether the employee's time is billable to customers
BirthDate	string	–	Birth date (YYYY-MM-DD)
DisplayName	string	yes	Display name (required, must be unique)
EmployeeNumber	string	–	Internal employee number
FamilyName	string	–	Last name
GivenName	string	–	First name
HiredDate	string	–	Hire date (YYYY-MM-DD)
MiddleName	string	–	Middle name
PrimaryAddr	object	–	Home address (Line1, City, CountrySubDivisionCode, PostalCode)
PrimaryEmailAddr	object	–	Email, e.g. {"Address": "employee@example.com"}
PrimaryPhone	object	–	Phone, e.g. {"FreeFormNumber": "555-1234"}
ReleasedDate	string	–	Termination date (YYYY-MM-DD)
SyncToken	string	yes	Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it)
employeeId	string	yes	The Employee ID to update

No output schema declared.

No examples provided.

qbo_estimates_create ~216

Create a new Estimate record in QuickBooks Online.

Input Output Examples

Name	Type	Req	Description
AcceptedBy	string	–	Name of the customer contact who accepted
AcceptedDate	string	–	Acceptance date
BillEmail	object	–	Email address, e.g. {"Address": "customer@example.com"}
CustomerMemo	object	–	Memo visible to customer, e.g. {"value": "Thank you"}
CustomerRef	object	yes	Customer being quoted, e.g. {"value": "123"}
DocNumber	string	–	Estimate number
ExpirationDate	string	–	Expiration date
Line	array	yes	Quote lines: {Amount, DetailType: "SalesItemLineDetail", SalesItemLineDetail: {ItemRef, Qty, UnitPrice}}.
PrivateNote	string	–	Private internal note
TxnDate	string	–	Estimate date (YYYY-MM-DD)
TxnStatus	string	–	Status: "Pending", "Accepted", "Rejected", or "Closed"

No output schema declared.

No examples provided.

Install

How do I install the QuickBooks Online MCP server?

QuickBooks Online runs locally as a container image, launched with docker run --rm -i -e QBO_CLIENT_ID -e QBO_CLIENT_SECRET -e QBO_REFRESH_TOKEN -e QBO_REALM_ID -e QBO_ENVIRONMENT -e MCP_TRANSPORT -e AUTH_MODE -e LOG_LEVEL ghcr.io/wyre-ai/qbo-mcp:v1.6.6. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

oci · ghcr.io/wyre-ai/qbo-mcp

Client

Showing Claude. Snippets for every client (markdown)

# add to Claude Code

claude mcp add wyre-ai-qbo-mcp -- docker run --rm -i -e QBO_CLIENT_ID -e QBO_CLIENT_SECRET -e QBO_REFRESH_TOKEN -e QBO_REALM_ID -e QBO_ENVIRONMENT -e MCP_TRANSPORT -e AUTH_MODE -e LOG_LEVEL ghcr.io/wyre-ai/qbo-mcp:v1.6.6

This image reads QBO_CLIENT_ID, QBO_CLIENT_SECRET, QBO_REFRESH_TOKEN, QBO_REALM_ID, QBO_ENVIRONMENT, MCP_TRANSPORT, AUTH_MODE and LOG_LEVEL. Set them in your client's env block for this server; docker run -e passes each one through to the container.

Common questions

What is the QuickBooks Online MCP server?

QuickBooks Online is an MCP server listed in the public MCP registry as io.github.WYRE-AI/qbo-mcp. MCP server for QuickBooks Online, accounts, customers, invoices, bills, and reports. This page covers its container image (ghcr.io/wyre-ai/qbo-mcp).

Is the QuickBooks Online MCP server safe to use?

QuickBooks Online scores 42 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the QuickBooks Online MCP server expose?

QuickBooks Online exposes 138 tools: qbo_navigate, qbo_status, qbo_customers_list, qbo_customers_get, qbo_customers_create, and 133 more. Their descriptions and schemas cost roughly 16,844 tokens of context every time the server is loaded.

Is the QuickBooks Online MCP server still maintained?

QuickBooks Online is still listed as active in the MCP registry. We last reached this channel on 17 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the QuickBooks Online MCP server under?

QuickBooks Online declares the Apache-2.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Badge

Put this score in your README. The image is served from a stable URL, updates when the score does, and links back to the evidence on this page. It shows nothing that is not already published here.

Score Verified Plain

The two-cell badge: our name, and this channel's current score out of 100.

Markdown

 [![VerifyMCP trust score for QuickBooks Online](https://verifymcp.io/badge/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp.svg)](https://verifymcp.io/servers/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp)

HTML

 <a href="https://verifymcp.io/servers/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp"><img src="https://verifymcp.io/badge/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp.svg" alt="VerifyMCP trust score for QuickBooks Online" height="20"></a>

A single cell stating that the server is listed here. Carries no number.

Markdown

 [![VerifyMCP trust score for QuickBooks Online](https://verifymcp.io/badge/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp.svg?variant=verified)](https://verifymcp.io/servers/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp)

HTML

 <a href="https://verifymcp.io/servers/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp"><img src="https://verifymcp.io/badge/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp.svg?variant=verified" alt="VerifyMCP trust score for QuickBooks Online" height="20"></a>

The score alone, tier-coloured, for a badge row that is already crowded.

Markdown

 [![VerifyMCP trust score for QuickBooks Online](https://verifymcp.io/badge/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp.svg?variant=plain)](https://verifymcp.io/servers/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp)

HTML

 <a href="https://verifymcp.io/servers/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp"><img src="https://verifymcp.io/badge/wyre-ai-qbo-mcp/ghcr-io-wyre-ai-qbo-mcp.svg?variant=plain" alt="VerifyMCP trust score for QuickBooks Online" height="20"></a>

Score history · last 30 days

14 Oct 17 Oct