Can I use FreshBooks as a CLI?

Yes. KosmoKrator exposes a FreshBooks CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose FreshBooks through MCP?

Yes. The KosmoKrator MCP gateway can expose selected FreshBooks tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are FreshBooks credentials stored?

FreshBooks credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for FreshBooks MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

accounting

FreshBooks CLI for Headless Automation

Use the FreshBooks CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

8 functions 7 read 1 write Bearer token auth

Submit FreshBooks feedback View package source

FreshBooks CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The FreshBooks CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# FreshBooks CLI for Headless Automation
kosmokrator integrations:configure freshbooks --set access_token="$FRESHBOOKS_ACCESS_TOKEN" --set account_id="$FRESHBOOKS_ACCOUNT_ID" --enable --read allow --write ask --json
kosmo integrations:call freshbooks.freshbooks_list_invoices '{"search":"example_search","page":1,"per_page":1}' --json

Discovery Before Execution

Agents and scripts can inspect FreshBooks docs and schemas before choosing a function.

kosmo integrations:docs freshbooks --json
kosmo integrations:docs freshbooks.freshbooks_list_invoices --json
kosmo integrations:schema freshbooks.freshbooks_list_invoices --json
kosmo integrations:search "FreshBooks" --json
kosmo integrations:list --json

Useful FreshBooks CLI Functions

Function	Type	Parameters	Description
`freshbooks.freshbooks_list_invoices`	Read	search, page, per_page	List invoices from FreshBooks. Returns invoice details including status, amounts, client info, and dates. Supports filtering by status, client, date range, and more.
`freshbooks.freshbooks_get_invoice`	Read	invoice_id	Get details of a specific FreshBooks invoice by ID. Returns full invoice data including line items, amounts, client details, status, and payment info.
`freshbooks.freshbooks_create_invoice`	Write	client_id, lines, date, due_date, invoice_number, notes, terms, discount_value, discount_type	Create a new invoice in FreshBooks. Requires at minimum a client ID and line items. Supports setting due date, notes, discount, and other invoice fields.
`freshbooks.freshbooks_list_clients`	Read	search, page, per_page	List clients from FreshBooks. Returns client details including name, email, company, and balance. Supports filtering and pagination.
`freshbooks.freshbooks_get_client`	Read	client_id	Get details of a specific FreshBooks client by ID. Returns full client profile including contact info, company details, and outstanding balance.
`freshbooks.freshbooks_list_projects`	Read	search, page, per_page	List projects from FreshBooks. Returns project details including title, description, billing method, budget, and active status. Supports filtering and pagination.
`freshbooks.freshbooks_list_payments`	Read	search, page, per_page	List payments from FreshBooks. Returns payment details including amount, date, client, invoice, and payment method. Supports filtering and pagination.
`freshbooks.freshbooks_get_current_user`	Read	none	Get the profile of the currently authenticated FreshBooks user. Returns user details including name, email, and linked business/member information. Useful for verifying connection and identity.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related FreshBooks CLI Pages

CI FreshBooks CLI for CI. Cron Jobs FreshBooks CLI for cron jobs. Shell Scripts FreshBooks CLI for shell scripts. Coding Agents FreshBooks CLI for coding agents.