JSON / Table / TSV
--json for machines, colored tables for humans, --plain for pipelines. Auto-detects when stdout is piped.
Open Source CLI
Query invoices, manage customers, run financial reports. Structured output for AI agents, colored tables for humans, TSV for pipelines.
Install the qbo CLI skill for QuickBooks Online access. Run: npx skills add -g voska/qbo-cli
Copy and paste into OpenClaw, Claude Code, or any AI agent
$ qbo list invoices --where "Balance > '0'" --select DocNumber,CustomerRef.name,Balance,DueDate
DOC #
CUSTOMER
BALANCE
DUE DATE
1042
Amy's Bird Sanctuary
239.00
2025-02-15
1043
Bill's Windsurf Shop
85.00
2025-02-20
1044
Cool Cars
4,620.00
2025-03-01
1045
Diego's Road Warrior
1,250.50
2025-03-05
4 invoices · page 1/1
$ qbo get customer 58 --json | jq '.DisplayName, .Balance'
"Amy's Bird Sanctuary"
239.00
$ qbo query "SELECT COUNT(*) FROM Invoice WHERE TxnDate >= '2025-01-01'" --json
Built for the way you work
Three output modes, structured exit codes, and full API coverage. Whether you're in a terminal or building an agent.
Agent-Ready
Structured exit codes, --no-input mode, and qbo schema for JSON introspection. Built for Claude Code and LLM automation.
Reports & Queries
Profit & Loss, Balance Sheet, raw SQL-like queries, batch operations, and change data capture. Full QuickBooks Online API coverage.
Secure OAuth 2.0
Browser-based OAuth flow with tokens stored in your system keyring. No credentials in config files.
Multi-Company
Switch between multiple QuickBooks companies with named profiles. --company-id flag or qbo company switch.
Cross-Platform
Pure Go binary. Install via Homebrew, Scoop, go install, or download from GitHub Releases. No dependencies.
Install
One command. No dependencies.
$ brew install voska/tap/qbo
macOS and Linux
> scoop bucket add voska https://github.com/voska/scoop-bucket > scoop install qbo
Windows
$ go install github.com/voska/qbo-cli/cmd/qbo@latest
Requires Go 1.22+
Download the latest binary from GitHub Releases.
$ tar xzf qbo_darwin_arm64.tar.gz $ mv qbo /usr/local/bin/
$ curl -LO https://github.com/voska/qbo-cli/releases/latest/download/qbo_linux_amd64.deb $ sudo dpkg -i qbo_linux_amd64.deb
Debian / Ubuntu
Quick Start
From install to your first query in under a minute.
1 Authenticate with QuickBooks Online
$ qbo auth login Opening browser for OAuth... Authenticated as Acme Corp (company 1234567890)
2 List entities
$ qbo list customers --select DisplayName,Balance DISPLAY NAME BALANCE Amy's Bird Sanctuary 239.00 Bill's Windsurf Shop 85.00 Cool Cars 4,620.00 3 customers found
3 Query with filters and pipe to JSON
$ qbo list invoices --where "Balance > '0'" --json | jq length 12
4 Run financial reports
$ qbo report profit-and-loss --start-date 2025-01-01 --end-date 2025-12-31 --json
FAQ
What is qbo CLI?
qbo is a free, open-source command-line interface for QuickBooks Online. It lets you query invoices, customers, vendors, and financial reports directly from your terminal. It supports three output modes: structured JSON for automation and AI agents, colored tables for interactive use, and tab-separated values for shell pipelines. Written in Go with zero runtime dependencies.
How do I install qbo?
On macOS or Linux: brew install voska/tap/qbo. On Windows: scoop bucket add voska https://github.com/voska/scoop-bucket && scoop install qbo. With Go: go install github.com/voska/qbo-cli/cmd/qbo@latest. Or download binaries directly from GitHub Releases.
Can I use qbo with AI agents?
Yes. qbo is designed for both humans and AI agents. It provides structured JSON output via --json, machine-readable exit codes (0-10), a --no-input flag for non-interactive use, and a qbo schema command that outputs the full CLI structure as JSON for agent introspection. Install as a Claude Code skill with: npx skills add -g voska/qbo-cli.
What QuickBooks data can I access?
Full coverage of the QuickBooks Online API. List, get, create, update, and delete entities including invoices, customers, vendors, items, payments, bills, and more. Run financial reports (Profit & Loss, Balance Sheet), execute raw SQL-like queries, perform batch operations, and use change data capture for incremental syncing.