freshbooks-cli
by haseebuchiha
Speech & TranscriptionBrief
FreshBooks CLI for managing invoices, clients, and billing.
Description
What This Skill Does
CLI tool for managing FreshBooks invoices, clients, and billing via the official FreshBooks API SDK. Authenticate once with OAuth2 and interact with your FreshBooks account from the terminal.
Lets you create and manage invoices programmatically or via AI agents without navigating the FreshBooks web UI.
When to Use It
- Create and send invoices to clients from the terminal
- Look up a client's billing history by organization name
- Onboard a new client and generate their first invoice in one workflow
- Get a shareable invoice link without opening the FreshBooks web app
- Automate invoice creation by piping JSON line items from scripts
Example Workflow
User asks: Create an invoice for Acme Corp for $5,000 of consulting services
- 1
Run
freshbooks clients list -s "Acme Corp"to find the client ID - 2
Run
freshbooks invoices create --client-id <id> --lines '[{"name":"Consulting","qty":1,"unitCost":{"amount":"5000.00","code":"USD"}}]'to create the invoice - 3
Run
freshbooks invoices share-link <invoice-id>to retrieve the shareable link - 4
Return the link to the user
A shareable FreshBooks invoice URL for Acme Corp
Requirements
- FreshBooks account
- FRESHBOOKS_CLIENT_ID — OAuth2 client ID from FreshBooks Developer Portal
- FRESHBOOKS_CLIENT_SECRET — OAuth2 client secret from FreshBooks Developer Portal
Installation
clawhub install haseebuchiha/freshbooks-cliRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.