Can I use Freeagent as a CLI?

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

Can I expose Freeagent through MCP?

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

Where are Freeagent credentials stored?

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

Can I deny write access for Freeagent MCP tools?

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

other

Freeagent MCP, CLI, and Lua Integration for AI Agents

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

9 functions 7 read 2 write Manual OAuth token auth

Submit Freeagent feedback View package source

Freeagent 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: freeagent
route_slug: freeagent
package: freeagent
auth_strategy: oauth2_manual_token Manual OAuth 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. Freeagent CLIHeadless setup and direct function calls. Freeagent 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.

Freeagent MCP Client Matrix

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

Freeagent CLI Matrix

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

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

Function Catalog

Function	Type	Parameters	Description
`freeagent.freeagent_list_invoices`	Read `read`	7	List invoices from FreeAgent. Returns a paginated list of invoices with their details. Supports filtering by status (Draft, Sent, Cancelled, Late Paid, Paid), date range, contact, and project.
`freeagent.freeagent_get_invoice`	Read `read`	1	Get the full details of a specific invoice from FreeAgent, including line items, totals, contact information, and status.
`freeagent.freeagent_create_invoice`	Write `write`	8	Create a new invoice in FreeAgent. Requires a contact and at least one line item. Supports setting due date, currency, invoice items with quantities and prices, and comments.
`freeagent.freeagent_list_contacts`	Read `read`	6	List contacts from FreeAgent. Returns a paginated list of contacts including customers, suppliers, and employees. Supports filtering and sorting.
`freeagent.freeagent_get_contact`	Read `read`	1	Get the full details of a specific contact from FreeAgent, including name, email, company, billing address, and contact type.
`freeagent.freeagent_create_contact`	Write `write`	13	Create a new contact in FreeAgent. Contacts can be customers, suppliers, or employees. Provide at least a name (first_name/last_name for individuals or organisation_name for companies).
`freeagent.freeagent_list_projects`	Read `read`	4	List projects from FreeAgent. Returns project names, status, budget, associated contacts, and time tracking information.
`freeagent.freeagent_list_expenses`	Read `read`	6	List expenses from FreeAgent. Returns expense claims with amounts, categories, dates, and associated projects or contacts.
`freeagent.freeagent_get_current_user`	Read `read`	0	Get the currently authenticated FreeAgent user profile. Returns user details like name, email, role, and company information. Useful for verifying the connection and understanding which account is active.