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 MCP, CLI, and Lua Integration for AI Agents

FreshBooks integration docs for AI agents: MCP gateway setup, FreshBooks CLI commands, Lua API reference, credentials, and function schemas.

8 functions 7 read 1 write Bearer token auth

Submit FreshBooks feedback View package source

FreshBooks for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: freshbooks
route_slug: freshbooks
package: freshbooks
auth_strategy: bearer_token Bearer token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. FreshBooks CLIHeadless setup and direct function calls. FreshBooks MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

FreshBooks MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for FreshBooks.

FreshBooks CLI Matrix

Use these pages for direct FreshBooks CLI workflows in scripts, CI, cron, and agent wrappers.

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

Function Catalog

Function	Type	Parameters	Description
`freshbooks.freshbooks_list_invoices`	Read `read`	3	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 `read`	1	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 `write`	9	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 `read`	3	List clients from FreshBooks. Returns client details including name, email, company, and balance. Supports filtering and pagination.
`freshbooks.freshbooks_get_client`	Read `read`	1	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 `read`	3	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 `read`	3	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 `read`	0	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.