quickbooks-automation
π―SkillInstallation
npx skills add composiohq/awesome-claude-skills --skill quickbooks-automationRun it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).
Uses skills.sh Β· Node.js 22.20+
After installing
Ask for related work and the agent uses it on its own, or call it yourself.
/QuickBooks AutomationInstall by hand
Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.
Open the skill folder β- This project
.claude/skills/quickbooks-automation/ - All projects
~/.claude/skills/quickbooks-automation/
These paths are for Claude Code. For other tools, the command above puts it in the right place.
SKILL.md
View on GitHub βQuickBooks Automation: manage invoices, customers, accounts, and payments in QuickBooks Online for streamlined bookkeeping
QuickBooks Automation
Automate QuickBooks Online operations including creating invoices, managing customers, querying accounts, and listing invoices for financial reporting.
Toolkit docs: composio.dev/toolkits/quickbooks
Setup
This skill requires the Rube MCP server connected at https://rube.app/mcp.
Before executing any tools, ensure an active connection exists for the quickbooks toolkit. If no connection is active, initiate one via RUBE_MANAGE_CONNECTIONS.
Core Workflows
1. Create an Invoice
Create a new invoice for a customer with line items.
Tool: QUICKBOOKS_CREATE_INVOICE
Key Parameters:
customer_id(required) -- ID of the customer (CustomerRef.value)lines(required) -- Array of line item objects. Each must include:DetailType-- e.g.,"SalesItemLineDetail"Amount-- Line item totalSalesItemLineDetail-- Object withItemRefcontainingvalue(item ID)
minorversion-- Optional API version parameter
Example:
Tool: QUICKBOOKS_CREATE_INVOICE
Arguments:
customer_id: "21"
lines: [
{
"DetailType": "SalesItemLineDetail",
"Amount": 150.00,
"SalesItemLineDetail": {
"ItemRef": {"value": "1", "name": "Services"}
}
}
]
Prerequisites: Resolve the customer ID using QUICKBOOKS_READ_CUSTOMER or create one with QUICKBOOKS_CREATE_CUSTOMER. Resolve item/account IDs using QUICKBOOKS_QUERY_ACCOUNT.
2. Manage Customers
Create and read customer records.
Tools:
QUICKBOOKS_CREATE_CUSTOMER-- Create a new customerQUICKBOOKS_READ_CUSTOMER-- Read a customer by ID
Key Parameters for QUICKBOOKS_CREATE_CUSTOMER:
display_name-- Display name (must be unique across customers, vendors, employees; max 500 chars)given_name-- First name (max 100 chars)family_name-- Last name (max 100 chars)middle_name-- Middle name (max 100 chars)title-- Title, e.g.,"Mr.","Dr."(max 16 chars)suffix-- Name suffix, e.g.,"Jr."(max 16 chars)
At least one of
display_name,title,given_name,middle_name,family_name, orsuffixis required.
Key Parameters for QUICKBOOKS_READ_CUSTOMER:
customer_id(required) -- ID of the customer to read
Example:
Tool: QUICKBOOKS_CREATE_CUSTOMER
Arguments:
display_name: "Acme Corporation"
given_name: "John"
family_name: "Doe"
3. Query and Read Accounts
Retrieve account information for use in invoice line items and financial reporting.
Tools:
QUICKBOOKS_QUERY_ACCOUNT-- Execute a query against accountsQUICKBOOKS_READ_ACCOUNT-- Read a specific account by ID
Key Parameters for QUICKBOOKS_QUERY_ACCOUNT:
query(required) -- SQL-like query string, e.g.,"SELECT * FROM Account WHERE AccountType = 'Income'"
Example:
Tool: QUICKBOOKS_QUERY_ACCOUNT
Arguments:
query: "SELECT * FROM Account WHERE AccountType = 'Income' MAXRESULTS 10"
4. List and Filter Invoices
Retrieve invoices with optional pagination and filtering.
Tool: QUICKBOOKS_LIST_INVOICES
Steps:
- Call
QUICKBOOKS_LIST_INVOICESwith pagination parameters - Use
start_positionandmax_resultsto page through results - Filter by specific criteria as needed
Recommended Execution Plan
- Resolve the customer using
QUICKBOOKS_READ_CUSTOMER(if you have a customer ID) or create one withQUICKBOOKS_CREATE_CUSTOMER - Resolve item/revenue accounts using
QUICKBOOKS_QUERY_ACCOUNTandQUICKBOOKS_READ_ACCOUNTto get account or item IDs for invoice line items - Create the invoice using
QUICKBOOKS_CREATE_INVOICEwith the resolvedcustomer_idand well-formed line items - Verify creation using
QUICKBOOKS_LIST_INVOICESto locate the new invoice by ID or DocNumber
Known Pitfalls
| Pitfall | Detail |
|---|---|
| Invalid references | QUICKBOOKS_CREATE_INVOICE fails if customer_id or ItemRef.value point to non-existent or inactive records. Always resolve IDs first. |
| Line item validation | Incorrect DetailType or missing SalesItemLineDetail fields cause schema/validation errors during invoice creation. |
| Pagination | QUICKBOOKS_LIST_INVOICES uses start_position and max_results. Incomplete pagination settings can miss invoices in larger books. |
| Sync tokens | Any later edits require the latest SyncToken from a fresh invoice read. Stale sync tokens cause update rejections. |
| Rate limits | QuickBooks enforces per-minute and daily API caps. High-volume runs should include backoff to avoid throttling errors. |
| DisplayName uniqueness | Customer display_name must be unique across all Customer, Vendor, and Employee objects. Duplicates cause creation failures. |
Quick Reference
| Tool Slug | Description |
|---|---|
QUICKBOOKS_CREATE_INVOICE | Create a new invoice with line items |
QUICKBOOKS_READ_CUSTOMER | Read a customer record by ID |
QUICKBOOKS_CREATE_CUSTOMER | Create a new customer record |
QUICKBOOKS_QUERY_ACCOUNT | Query accounts with SQL-like syntax |
QUICKBOOKS_READ_ACCOUNT | Read a specific account by ID |
QUICKBOOKS_LIST_INVOICES | List invoices with pagination |
Powered by Composio
More from this repository10
A Claude Code plugin that analyzes meeting notes and transcripts to extract key insights, action items, and decisions using Composio app integrations.
A Claude Code plugin from the Awesome Claude Skills collection that downloads videos from YouTube and other platforms for offline viewing, editing, or archival, with support for various formats and quality options.
A Claude Code plugin that assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback.
A Claude Code plugin that automatically organizes and categorizes files in your workspace using Composio integrations, helping maintain a clean project structure.
A Claude Code plugin providing tools for creating elaborate, multi-component HTML artifacts using React, Tailwind CSS, and shadcn/ui in claude.ai.
A Claude Code skill that randomly selects winners from participant lists, spreadsheets, or Google Sheets for giveaways and contests using cryptographically secure randomness.
A Claude Code plugin that automates Zoho CRM workflows including lead management, contact updates, deal tracking, account operations, and custom module interactions through Composio integration.
A Claude Code plugin that enforces brand consistency by checking code and content against your brand guidelines using Composio integrations.
A pre-built workflow skill for automating Help Scout via Composio, enabling Claude to manage conversations, customers, mailboxes, and tags through structured tool sequences and parameter guidance.
A Claude Code plugin that automatically creates user-facing changelogs from git commits by analyzing commit history and transforming technical commits into customer-friendly release notes.