other
Freeagent MCP Integration for Codex
Connect Freeagent to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.
Connect Freeagent to Codex
Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.
Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with
--write=deny so Codex can inspect read-capable tools without receiving write access by default.
Freeagent MCP Config for Codex
Keep write access denied or ask-based unless the workspace is trusted.
{
"mcpServers": {
"kosmokrator-freeagent": {
"type": "stdio",
"command": "kosmo",
"args": [
"mcp:serve",
"--integration=freeagent",
"--write=deny"
]
}
}
}Run the Gateway Manually
kosmokrator mcp:serve --integration=freeagent --write=denyWhy Use KosmoKrator Here
Expose only Freeagent instead of a broad multi-service tool list.
Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.
Start read-only, then opt into ask or allow for trusted workspaces.
Freeagent Tools Visible to Codex
Codex sees stable MCP tool names generated from the Freeagent integration catalog.
| MCP tool | Source function | Type | Description |
|---|---|---|---|
integration__freeagent__freeagent_list_invoices | freeagent.freeagent_list_invoices | Read | 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. |
integration__freeagent__freeagent_get_invoice | freeagent.freeagent_get_invoice | Read | Get the full details of a specific invoice from FreeAgent, including line items, totals, contact information, and status. |
integration__freeagent__freeagent_create_invoice | freeagent.freeagent_create_invoice | Write | 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. |
integration__freeagent__freeagent_list_contacts | freeagent.freeagent_list_contacts | Read | List contacts from FreeAgent. Returns a paginated list of contacts including customers, suppliers, and employees. Supports filtering and sorting. |
integration__freeagent__freeagent_get_contact | freeagent.freeagent_get_contact | Read | Get the full details of a specific contact from FreeAgent, including name, email, company, billing address, and contact type. |
integration__freeagent__freeagent_create_contact | freeagent.freeagent_create_contact | Write | 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). |
integration__freeagent__freeagent_list_projects | freeagent.freeagent_list_projects | Read | List projects from FreeAgent. Returns project names, status, budget, associated contacts, and time tracking information. |
integration__freeagent__freeagent_list_expenses | freeagent.freeagent_list_expenses | Read | List expenses from FreeAgent. Returns expense claims with amounts, categories, dates, and associated projects or contacts. |
integration__freeagent__freeagent_get_current_user | freeagent.freeagent_get_current_user | Read | 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. |