QuickBooks Online
OCI · GHCR.IO/WYRE-AI/QBO-MCP:V1.6.5 · SCANNED SEP 20
MCP server for QuickBooks Online — accounts, customers, invoices, bills, and reports.
Available components
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
- Malware scan not yet available for this package.Unverified
- Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.Unverified
- Install-script risk not yet assessed.Unverified
- Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.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 25 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability85
- 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 15575 tokens (~116/item across 134 items; 133 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 Management83
- Stability observed for 25 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 134 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.
How do I install the QuickBooks Online MCP server?
QuickBooks Online runs locally as a container image, launched with docker run --rm -i ghcr.io/wyre-ai/qbo-mcp:v1.6.5. 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:v1.6.5
claude mcp add wyre-ai-qbo-mcp -- docker run --rm -i ghcr.io/wyre-ai/qbo-mcp:v1.6.5
{
"mcpServers": {
"wyre-ai-qbo-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/wyre-ai/qbo-mcp:v1.6.5"
]
}
}
} {
"servers": {
"wyre-ai-qbo-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/wyre-ai/qbo-mcp:v1.6.5"
]
}
}
} codex mcp add wyre-ai-qbo-mcp -- docker run --rm -i ghcr.io/wyre-ai/qbo-mcp:v1.6.5
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"wyre-ai-qbo-mcp": {
"type": "local",
"command": [
"docker",
"run",
"--rm",
"-i",
"ghcr.io/wyre-ai/qbo-mcp:v1.6.5"
],
"enabled": true
}
}
} mcp_servers:
wyre-ai-qbo-mcp:
command: "docker"
args: ["run", "--rm", "-i", "ghcr.io/wyre-ai/qbo-mcp:v1.6.5"] {
"McpServers": {
"wyre-ai-qbo-mcp": {
"Transport": "stdio",
"Command": "docker",
"Arguments": [
"run",
"--rm",
"-i",
"ghcr.io/wyre-ai/qbo-mcp:v1.6.5"
]
}
}
} {
"mcpServers": {
"wyre-ai-qbo-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"ghcr.io/wyre-ai/qbo-mcp:v1.6.5"
]
}
}
} 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.
- 18 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 67 to 70. That category is still filling its 30-day observation window: 20 days of observed history at the previous scan, 21 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.
- 8 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.
- 6 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.
- 3 Sept 26 +4
- Stability: unverified → 0.27 ▲ functional
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 20 Sept 2026 · Analysed oci/ghcr.io/wyre-ai/qbo-mcp:v1.6.5
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 →
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 →
qbo_accounts_create ~195
Create a new Account record in QuickBooks Online.
| 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.
| 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.
| 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 ~80
Search Account records by Name (LIKE match).
| 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%' |
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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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 ~83
Search Bill records by DocNumber (LIKE match).
| 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%' |
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.
| 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.
| 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.
| 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.
| 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 ~80
Search Class records by Name (LIKE match).
| 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%' |
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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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 ~83
Search Customer records by DisplayName (LIKE match).
| 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%' |
No output schema declared.
No examples provided.
qbo_departments_create ~65
Create a new Department record in QuickBooks Online.
| 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.
| 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.
| 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 ~81
Search Department records by Name (LIKE match).
| 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%' |
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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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.
| 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 ~83
Search Employee records by DisplayName (LIKE match).
| 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%' |
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.
| 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.
| 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.
qbo_estimates_get ~32
Get a specific Estimate record by its ID.
| Name | Type | Req | Description |
|---|---|---|---|
| estimateId | string | yes | The unique Estimate ID |
No output schema declared.
No examples provided.
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:v1.6.5).
Is the QuickBooks Online MCP server safe to use?
QuickBooks Online scores 52 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 133 tools: qbo_navigate, qbo_status, qbo_customers_list, qbo_customers_get, qbo_customers_create, and 128 more. Their descriptions and schemas cost roughly 15,557 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 20 September 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.