From quickbooks-skill
Queries QuickBooks Online read-only API via CLI for customers, vendors, invoices, bills, purchases, deposits, time activities, employees, accounts, items, and more.
How this skill is triggered — by the user, by Claude, or both
Slash command
/quickbooks-skill:quickbooksThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Read-only access to QuickBooks Online data including customers, vendors, invoices, bills, purchases, deposits, time activities, and more.
Read-only access to QuickBooks Online data including customers, vendors, invoices, bills, purchases, deposits, time activities, and more.
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts setup to see setup instructions.claude/quickbooks-skill.local.jsonnpx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts refresh to get access tokennpx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts check to verify connectionTokens are stored per-project in .claude/quickbooks-skill.local.json.
# Display setup instructions
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts setup
# Check connection status and company info
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts check
# Refresh access token (tokens expire after 1 hour)
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts refresh
All query commands support date filtering and pagination.
# List customers
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts customers
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts customers --start=2024-01-01 --end=2024-12-31
# List vendors
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts vendors
# List employees
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts employees
# List invoices
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts invoices --start=2024-01-01
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts invoices --query-by=TxnDate
# List bills
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts bills --start=2024-01-01
# List purchases (checks, expenses, etc.)
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts purchases --start=2024-01-01
# List deposits
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts deposits --start=2024-01-01
# List payments
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts payments --start=2024-01-01
# List time activities
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts timeactivities --start=2024-01-01
# List accounts (chart of accounts)
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts accounts
# List items (products/services)
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts items
# List estimates
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts estimates --start=2024-01-01
# List sales receipts
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts salesreceipts --start=2024-01-01
# List credit memos
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts creditmemos --start=2024-01-01
# List journal entries
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts journalentries --start=2024-01-01
# Get a specific customer
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts get Customer 123
# Get a specific invoice
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts get Invoice 456
# Get a specific purchase
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts get Purchase 789
# Get Account ID to name mapping
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts refs Account
# Get Customer ID to name mapping
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts refs Customer
# Get Vendor ID to name mapping
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts refs Vendor
| Option | Description | Example |
|---|---|---|
--start=DATE | Start date filter (YYYY-MM-DD) | --start=2024-01-01 |
--end=DATE | End date filter (YYYY-MM-DD) | --end=2024-12-31 |
--query-by=FIELD | Date field to filter on | --query-by=TxnDate |
--where=CONDITION | Additional WHERE clause | --where="Active = true" |
--max=N | Max results per page (default: 1000) | --max=100 |
MetaData.LastUpdatedTime - When record was last modified (default)TxnDate - Transaction date (for transactions)MetaData.CreateTime - When record was created| Entity | Command | Has TxnDate |
|---|---|---|
| Customer | customers | No |
| Vendor | vendors | No |
| Employee | employees | No |
| Account | accounts | No |
| Item | items | No |
| Invoice | invoices | Yes |
| Bill | bills | Yes |
| Purchase | purchases | Yes |
| Deposit | deposits | Yes |
| Payment | payments | Yes |
| TimeActivity | timeactivities | Yes |
| Estimate | estimates | Yes |
| SalesReceipt | salesreceipts | Yes |
| CreditMemo | creditmemos | Yes |
| JournalEntry | journalentries | Yes |
All commands return JSON with success and data fields.
{
"success": true,
"data": {
"results": [...],
"count": 42,
"entity": "Customer"
}
}
npx tsx ${CLAUDE_PLUGIN_ROOT}/scripts/quickbooks.ts --help
npx claudepluginhub the-focus-ai/claude-marketplace --plugin quickbooks-skillAutomates QuickBooks Online operations including creating invoices, managing customers, and querying accounts for streamlined bookkeeping.
Provides QuickBooks Online API patterns for OAuth2 authentication, REST endpoints, Intuit query language, pagination, rate limiting, error handling, minor versions, base URLs, and sandbox/production setups.
API reference and usage guide for freee accounting, HR, invoicing, project management, sales, IT asset management, and e-signatures. Activates when users ask about freee data operations including expense reports, time tracking, sales management, and document management.