freshbooks-cli

What This Skill Does

The freshbooks-cli skill provides a robust interface for interacting with the FreshBooks accounting platform directly from the OpenClaw agent environment. By leveraging the official @freshbooks/api SDK, it allows users to perform critical accounting tasks such as managing client databases, generating professional invoices, and monitoring billing status. This tool is designed to automate repetitive financial workflows, reducing manual data entry and ensuring that accounting records remain consistent across systems. Whether you are managing long-term retainer clients or processing ad-hoc project invoices, this skill streamlines the end-to-end process of financial operations.

Installation

To integrate this skill, use the command: clawhub install openclaw/skills/skills/haseebuchiha/freshbooks-cli. Before execution, ensure the system environment is configured with the required @haseebuchiha registry in your .npmrc file. Initial setup requires a one-time OAuth2 authentication via the --manual flag, as the SDK requires an OOB (out-of-band) flow. Run freshbooks auth login --client-id <id> --client-secret <secret> --manual, complete the browser-based authorization, and paste the resulting code into the terminal to finalize the setup.

Use Cases

• Client Onboarding: Rapidly register new client organizations and associated contacts without leaving the agent workspace.
• Billing Automation: Automate the creation of recurring invoices based on predefined line-item templates.
• Financial Reporting: Quickly query invoice statuses, search for specific client records by organization, and verify billing logs.
• Account Management: Archive outdated invoices or retrieve shareable payment links to send directly to clients.

Example Prompts

1. "List all my active clients and then create a new invoice for Taha at abcg.io for 15000 USD for web services."
2. "Show me the status of the invoice for client ID 818183 and provide the shareable link if it exists."
3. "Check if I have any pending invoices and refresh my authentication tokens if necessary."

Tips & Limitations

• Security: Tokens are stored in ~/.config/freshbooks-cli/config.json with 0600 permissions. Ensure your environment directory is secure.
• Operations: FreshBooks does not support permanent deletion of invoices; always use the archive command for cleanup.
• JSON Complexity: When using the --data flag for full payload creation, ensure your JSON is minified or properly escaped within quotes to prevent CLI parsing errors. The SDK automatically refreshes tokens, but if you encounter authentication errors, use freshbooks auth refresh to force a renewal.