Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
FreshBooks CLI for managing invoices, clients, and billing. Use when the user mentions freshbooks, invoicing, billing, clients, or accounting.
FreshBooks CLI for managing invoices, clients, and billing. Use when the user mentions freshbooks, invoicing, billing, clients, or accounting.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
CLI tool for managing FreshBooks invoices, clients, and billing. Uses the official @freshbooks/api SDK.
npm install -g @haseebuchiha/freshbooks-cli Requires .npmrc with @haseebuchiha:registry=https://npm.pkg.github.com for GitHub Package Registry.
Authenticate with FreshBooks OAuth2. You must use the --manual flag (localhost redirect does not work with FreshBooks). freshbooks auth login \ --client-id "<FRESHBOOKS_CLIENT_ID>" \ --client-secret "<FRESHBOOKS_CLIENT_SECRET>" \ --manual This opens the browser. Authorize, then copy the code from the page and paste it into the CLI. Tokens are stored at ~/.config/freshbooks-cli/config.json (0600 permissions) and auto-refresh before expiry. Verify: freshbooks auth status
freshbooks auth login --client-id <id> --client-secret <secret> --manual -- authenticate via OAuth2 OOB flow freshbooks auth logout -- clear stored tokens and credentials freshbooks auth status -- show account ID, token expiry, and auth state freshbooks auth refresh -- manually refresh the access token
freshbooks clients list [-p <page>] [--per-page <n>] [-s <search>] -- list clients, search by org name freshbooks clients get <id> -- get a single client by ID freshbooks clients create [--fname <name>] [--lname <name>] [--email <email>] [--organization <org>] -- create a client freshbooks clients create --data '<json>' -- create with full JSON payload freshbooks clients update <id> --data '<json>' -- update a client Example: freshbooks clients create --fname "Taha" --organization "abcg.io"
freshbooks invoices list [-p <page>] [--per-page <n>] -- list invoices freshbooks invoices get <id> -- get a single invoice by ID freshbooks invoices create --client-id <id> [--lines '<json>'] -- create an invoice with line items freshbooks invoices create --client-id <id> --data '<json>' -- create with full JSON payload freshbooks invoices update <id> --data '<json>' -- update an invoice freshbooks invoices archive <id> -- archive an invoice (no permanent delete in FreshBooks) freshbooks invoices share-link <id> -- get a shareable link for an invoice
Lines are a JSON array. Each line has name, qty, and unitCost (money object): [ {"name": "Web Services", "qty": 1, "unitCost": {"amount": "15000.00", "code": "USD"}}, {"name": "App Services", "qty": 1, "unitCost": {"amount": "15000.00", "code": "USD"}} ] Example (full invoice create): freshbooks invoices create --client-id 818183 \ --lines '[{"name":"Web Services","qty":1,"unitCost":{"amount":"15000.00","code":"USD"}},{"name":"App Services","qty":1,"unitCost":{"amount":"15000.00","code":"USD"}}]'
freshbooks clients create --fname "Name" --organization "Company" -- note the returned id freshbooks invoices create --client-id <id> --lines '[...]' -- create the invoice freshbooks invoices share-link <invoice-id> -- get shareable link
freshbooks clients list -s "company name" -- find the client ID freshbooks invoices list -- list all invoices (filter by client in output) freshbooks invoices get <id> -- get full invoice details
All output is JSON to stdout. Pipe to jq for filtering: freshbooks clients list | jq '.clients[].organization' Money values are {"amount": "string", "code": "USD"}. The amount is always a string like "30000.00", never a number. Do not use parseFloat on money. archive sets vis_state=1. FreshBooks does not support permanent deletion. Tokens auto-refresh. If refresh fails, re-run freshbooks auth login --client-id <id> --client-secret <secret> --manual. Client credentials can also be read from env vars FRESHBOOKS_CLIENT_ID and FRESHBOOKS_CLIENT_SECRET (takes priority over stored config). Always use --manual for auth login. The localhost callback redirect URI does not work with FreshBooks. Confirm with the user before creating invoices or modifying billing data.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.