FreeAgent MCP server
36 operations0 webhooks
Manage FreeAgent company records, verified sender addresses, contacts, projects, invoices, and tracking groups through its OAuth 2.0 REST API.
Try FreeAgent with your agent
Connect FreeAgent, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in FreeAgent on my account, then run one read-only example and show me the result.
FreeAgent tools and triggers
Tools are what your agent can do in FreeAgent through Corsair's MCP server. Triggers are the FreeAgent events a routine can start from.
Invoices
- Convert To Credit NoteDestructive
Convert a draft negative invoice into a credit note
invoices.convertToCreditNote
- CreateWrite
Create an invoice in Draft status
invoices.create
- DeleteDestructive
Delete an invoice
invoices.delete
- Delete Default Additional TextWrite
Remove the default additional text from company invoices
invoices.deleteDefaultAdditionalText
- Direct DebitDestructive
Take payment using an eligible GoCardless mandate
invoices.directDebit
- DuplicateWrite
Duplicate an invoice as a new draft using the next reference
invoices.duplicate
- GetRead-only
Get an invoice by its FreeAgent ID
invoices.get
- Get Default Additional TextRead-only
Get the default additional text for company invoices
invoices.getDefaultAdditionalText
- ListRead-only
List invoices with documented filters and pagination
invoices.list
- Mark CancelledDestructive
Cancel and write off an eligible sent invoice
invoices.markCancelled
- Mark DraftDestructive
Return an invoice to Draft status
invoices.markDraft
- Mark ScheduledDestructive
Schedule an invoice to be emailed
invoices.markScheduled
- Mark SentDestructive
Mark an invoice as sent or reopen a cancelled invoice
invoices.markSent
- PdfRead-only
Get the invoice PDF as base64 encoded JSON content
invoices.pdf
- Send EmailDestructive
Send an invoice email to its recipient
invoices.sendEmail
- TimelineRead-only
List invoice timeline entries
invoices.timeline
- UpdateWrite
Update an invoice without changing its status
invoices.update
- Update Default Additional TextWrite
Update the default additional text for company invoices
invoices.updateDefaultAdditionalText
Contacts
- CreateWrite
Create a contact using documented contact fields
contacts.create
- DeleteDestructive
Delete a contact
contacts.delete
- GetRead-only
Get a contact by its FreeAgent ID
contacts.get
- ListRead-only
List contacts with documented filters and pagination
contacts.list
- UpdateWrite
Update documented fields on a contact
contacts.update
Projects
- CreateWrite
Create a project with documented project fields
projects.create
- DeleteDestructive
Delete a project
projects.delete
- GetRead-only
Get a project by its FreeAgent ID
projects.get
- ListRead-only
List projects with documented filters and pagination
projects.list
- UpdateWrite
Update documented fields on a project
projects.update
Company
- Business CategoriesRead-only
List the documented business categories for company profiles
company.businessCategories
- GetRead-only
Get the authenticated company profile
company.get
- Tax TimelineRead-only
List upcoming tax events and due dates for the company
company.taxTimeline
Recurring Invoices
- GetRead-only
Get a recurring invoice by its FreeAgent ID
recurringInvoices.get
- ListRead-only
List recurring invoices with documented filters and pagination
recurringInvoices.list
Tracking Groups
- GetRead-only
Get a tracking group and its labels by FreeAgent ID
trackingGroups.get
- ListRead-only
List tracking groups with documented filters and pagination
trackingGroups.list
Email Addresses
- ListRead-only
List verified sender email addresses for the company
emailAddresses.list
Connect FreeAgent to Claude, ChatGPT or Cursor
- 1
Connect FreeAgent in Corsair
Sign in to FreeAgent once in Corsair. Corsair stores the credential encrypted and makes the FreeAgent API calls for your agent, so it never goes into a prompt or a config file. Connect FreeAgent
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs FreeAgent. On a ChatGPT personal plan, connect FreeAgent here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, FreeAgent's read and write operations run right away and its 10 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/freeagent, add the FreeAgent plugin, and connect with OAuth. Then call methods like corsair.freeagent.api.company.businessCategories() from your app. Corsair stores tokens, and keeps each tenant isolated.
Yes. FreeAgent needs an OAuth app with scopes that match what you automate. Register the app in FreeAgent, configure redirect URLs, then connect through Corsair or managed OAuth in Hub.
Yes. One Corsair client can hit FreeAgent, GitHub, Notion, Stripe, and the rest. Trigger FreeAgent from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for manage FreeAgent company records, verified sender addresses, contacts, projects, invoices, and tracking groups through its OAuth 2.0 REST API. Common builds include sync jobs, admin tooling, and agents that call FreeAgent APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per FreeAgent API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/freeagent in the open repo. When FreeAgent ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your FreeAgent data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store FreeAgent data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put FreeAgent on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 10 destructive FreeAgent operations. You can change a link's mode at hub.corsair.dev/me.