A professional command-line interface for managing FreshBooks accounting, invoices, and client data using the official API SDK.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install freshbooks-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install freshbooks-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is freshbooks-cli?
The freshbooks-cli is a robust developer tool designed to bring the power of FreshBooks accounting directly into your terminal or automated workflows. By leveraging this entry in the Openclaw Skills collection, developers can programmatically handle financial operations, from client creation to complex invoice generation, without needing to navigate the web UI.
Built on the official FreshBooks API SDK, it ensures type-safe interactions and follows professional accounting standards, such as string-based currency handling to prevent floating-point errors. It is an essential utility for freelancers and agencies looking to integrate their billing systems into larger DevOps or productivity stacks.
freshbooks-cli Use Cases
- Automating the creation of new clients during the onboarding process.
- Batch generating invoices with multiple line items for recurring services.
- Programmatically retrieving shareable payment links to send to clients via chat or email.
- Searching and filtering client databases through the terminal using jq integration.
- Archiving old invoices to maintain a clean billing history.
How freshbooks-cli Works
- The user authenticates the CLI via a manual OAuth2 flow to establish a secure connection with FreshBooks.
- Access tokens are stored locally with strict file permissions and are automatically refreshed before they expire.
- Developers use specific subcommands (clients, invoices, auth) to send structured JSON payloads to the FreshBooks API.
- The tool processes API responses and outputs clean JSON to stdout for immediate review or further processing.
- Workflow sequences allow for multi-step operations, such as looking up a client ID before generating a corresponding invoice.
freshbooks-cli Setup
First, ensure your .npmrc is configured to access the GitHub Package Registry. Then, install the package globally:
npm install -g @haseebuchiha/freshbooks-cli
To authenticate, use your FreshBooks API credentials with the manual flag:
freshbooks auth login \
--client-id "<YOUR_CLIENT_ID>" \
--client-secret "<YOUR_CLIENT_SECRET>" \
--manual
Verify your connection by running freshbooks auth status.
freshbooks-cli Data Schema & Taxonomy
The skill returns all data in JSON format, making it highly compatible with other Openclaw Skills and command-line utilities. Key data structures include:
| Entity | Structure | Notes |
|---|---|---|
| Client | {"fname": string, "organization": string, ...} |
Searchable by organization name. |
| Invoice | {"client_id": integer, "lines": array, ...} |
Supports partial updates and archiving. |
| Money | {"amount": "1500.00", "code": "USD"} |
Amount is always a string to ensure precision. |
| Line Items | [{"name": string, "qty": number, "unitCost": object}] |
Nested within invoice creation payloads. |
freshbooks-cli Advanced Features
- Manual OAuth2 Out-Of-Band (OOB) flow support for environments where localhost redirects are restricted.
- Automatic token lifecycle management with built-in refresh logic to prevent workflow interruptions.
- Secure credential management via local config files or system environment variables for CI/CD integration.
- High-precision financial data handling using string-based decimal representation for all currency values.
- Comprehensive JSON output for every command, enabling advanced filtering and piping into secondary automation scripts.
SKILL.md
Loading
Related Openclaw Skills
AI Stock Insider
A sophisticated AI agent skill for generating real-time A-share sector reports, mapping global news to stock movements, and analyzing US-market correlations.
Workspace Indexer
An automated utility that maintains a structured and searchable index of your workspace directories and project metadata.
Message Injector
A powerful OpenClaw extension that automatically prepends custom instructions or context to every user message before the agent processes it.
Perplexity AI Search (Safe Edition)
A security-hardened Perplexity API integration for real-time web-grounded search with citations.
Linear Browser Automation
A browser-based automation tool designed to manage Linear.app issues, triage, and status updates through a managed browser profile.
Linear Browser Automation
A powerful tool for automating Linear.app project management tasks via UI-driven browser interactions.
Featured*
