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.

data

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.

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.

Agent Surfaces

FreshBooks CLIHeadless setup, JSON output, direct function calls. FreshBooks MCPExpose selected tools to local MCP clients. FreshBooks LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

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

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.