Skip to content

Connectors · Accounting & finance

FreeAgent MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to FreeAgent and the rest of your systems. It gives your agent 203 FreeAgent actions (93 reads, 83 writes and 27 that wait for a confirmation) and holds the FreeAgent credential itself, so the agent never does. It paces FreeAgent's limits and records every call. Connecting FreeAgent needs your own FreeAgent OAuth app and one admin sign-in.

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

claude mcp add --transport http actionlake https://connect.actionlake.com/mcp
the first call
do {  action: "freeagent.invoices.list",  intent: "check which FreeAgent account is connected"}# List all invoices · read · 1 upstream call
  • 203actionsin one signed file
  • 93readlook, never change
  • 83writecreate and update
  • 27wait for a yesdestructive, confirmed first

Set up

Connect FreeAgent in three steps.

  1. 01

    Add actionlake to Claude.

    Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.

    https://connect.actionlake.com/mcp
  2. 02

    Connect FreeAgent.

    OAuth 2.0, authorization code. You register your own OAuth app with FreeAgent, an admin signs in once, and you paste the app's client id and secret and the tokens from that sign-in; actionlake renews the access token from then on. actionlake stores what you paste write-only, sealed under your tenant's key.

    Before the first sign-in, FreeAgent needs an OAuth app of your own, registered in its developer portal. actionlake has no FreeAgent app to lend you.

    • access_tokenAccess token from one sign-in with your own OAuth app
    • refresh_tokenRefresh token from the same sign-in; the access token is renewed from it
    • client_idFreeAgent OAuth identifier
    • client_secretFreeAgent OAuth secret for the same app
    account { op: "connections.requirements", service: "freeagent" }
    # free: exactly what to paste, and what is found for you
  3. 03

    Make the first call. Check before a write.

    Ask in plain words; Claude picks the action. Before anything changes, check validates the call and prices it, for free.

    do    { action: "freeagent.invoices.list" }# list all invoices · read · 1 upstream callcheck { action: "freeagent.invoices.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent

FreeAgent at a glance

Sign-in
OAuth 2.0, authorization code. You register your own OAuth app with FreeAgent, an admin signs in once, and you paste the app's client id and secret and the tokens from that sign-in; actionlake renews the access token from then on.
You provide
access_tokenrefresh_tokenclient_idclient_secret
Limits we pace to
120 calls a minute, per connection
API covered
FreeAgent API v2api.freeagent.com/v2
Built from
FreeAgent's documentation, read 23 October 2026dev.freeagent.com
Service file
Version 1.0.0, signed (Ed25519)
Cached reads
93 of 93 reads, for up to 5 minutes; a write clears what it affects
Shared entities
12, so ask can line FreeAgent up with your other systems
Data
Processed and stored in Sydney, Australia. No US region yet

Capabilities

What an AI agent can do in FreeAgent.

203 actions in 48 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

  • 93readlook, never change
  • 83writecreate and update
  • 27destructivewait for a confirmation
  1. Invoices

    18

    5 read · 11 write · 2 destructive

    List all invoices · Create an invoice · Get a single invoice · Update an invoice

  2. Estimates

    16

    4 read · 10 write · 2 destructive

    List all estimates · Create an estimate · Get a single estimate · Update an estimate

  3. Credit notes

    9

    3 read · 5 write · 1 destructive

    List all credit notes · Create a credit note · Get a single credit note · Update a credit note

  4. Timeslips

    7

    2 read · 3 write · 2 destructive

    List all timeslips · Create a timeslip · Update a timeslip · Get a single timeslip

  5. Users

    7

    3 read · 3 write · 1 destructive

    List all users · Create a user · Get a single user · Update a user

  6. Corporation tax returns

    6

    2 read · 4 write · 0 destructive

    List Corporation Tax Returns for a company · Fetch details for a Corporation Tax Return · Mark a Corporation Tax Return as Filed · Mark a Corporation Tax Return as Paid

  7. Expenses

    6

    3 read · 2 write · 1 destructive

    List all expenses · Create an expense · Get a single expense · Update an expense

  8. Journal sets

    6

    3 read · 2 write · 1 destructive

    List all journal sets · Create a journal set · Get a single journal set · Update a journal set

40 more areas · 128 actions
  • Self assessment returns 6
  • Vat returns 6
  • Bank accounts 5
  • Bank transaction explanations 5
  • Bills 5
  • Capital asset types 5
  • Categories 5
  • Contacts 5
  • Credit note reconciliations 5
  • Price list items 5
  • Projects 5
  • Properties 5
  • Sales tax periods 5
  • Tasks 5
  • Bank transactions 4
  • Final accounts reports 4
  • Notes 4
  • Payroll 4
  • Account locks 3
  • Account managers 3
  • Company 3
  • Estimate items 3
  • Accounting transactions 2
  • Attachments 2
  • Balance sheet 2
  • Bank feeds 2
  • Capital assets 2
  • Cis settings 2
  • Hire purchases 2
  • Recurring invoices 2
  • Stock items 2
  • Trial balance 2
  • Cashflow 1
  • Cis bands 1
  • Email addresses 1
  • Payroll profiles 1
  • Practice 1
  • Practice clients 1
  • Profit and loss 1
  • Sales tax 1

Top actions

The FreeAgent API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 74 of FreeAgent's 74 action names are shared with at least one other connector, so an agent learns them once.

ActionWhat it doesEffectSame name in
freeagent.invoices.listList all invoicesList all invoices.readfinance.invoice.list101 connectors
freeagent.estimates.listList all estimatesList all estimates.readfinance.quote.list52 connectors
freeagent.expenses.listList all expensesList all expenses.readfinance.expense.list40 connectors
freeagent.bank_accounts.listList bank accountsList bank accounts.readfinance.bank_account.list35 connectors
freeagent.credit_notes.listList all credit notesList all credit notes.readfinance.credit_note.list33 connectors
freeagent.bills.listList all billsList all bills.readfinance.bill.list31 connectors
freeagent.tasks.listList all tasksList all tasks.readwork.task.list122 connectors
freeagent.users.listList all usersList all users.readidentity.user.list474 connectors
freeagent.invoices.createCreate an invoiceCreate an invoice.writefinance.invoice.create74 connectors
freeagent.estimates.createCreate an estimateCreate an estimate.writefinance.quote.create52 connectors
freeagent.expenses.createCreate an expenseCreate an expense.writefinance.expense.create36 connectors
freeagent.invoices.deleteDelete an invoiceDelete an invoice.destructivefinance.invoice.delete56 connectors

Try it

Prompts to paste into Claude.

Each one names the FreeAgent actions it will call, so you know what it reads and what it changes before you send it.

  1. Readread

    Which FreeAgent invoices are more than 30 days overdue? Group them by customer with the total owed.

    callsfreeagent.invoices.list

  2. Writewrite

    Create an invoice in FreeAgent. Show me exactly what you will send before you save it.

    callsfreeagent.invoices.create

  3. Across systemsread

    For each customer, how many invoices are in FreeAgent and how many tickets in ConnectWise PSA?

    callsfreeagent.invoices.listconnectwise_manage.tickets.list

Across your systems

FreeAgent, joined to the rest of your business.

One ask fetches from FreeAgent and another system, joins the rows on the same customer on our side, and hands your agent the answer, not every row.

  • For each customer, how many invoices are in FreeAgent and how many tickets in ConnectWise PSA?

    freeagent.invoices.list + connectwise_manage.tickets.list, on crm.company · ConnectWise PSA

  • For each customer, how many invoices are in FreeAgent and how many tickets in HubSpot CRM?

    freeagent.invoices.list + hubspot_crm.tickets.list, on crm.company · HubSpot CRM

Also mapped by other connectorsidentity.user 517crm.company 227crm.contact 192work.project 116work.task 105finance.invoice 91finance.quote 45work.time_entry 40
ask
ask {  intent: "for each customer, how many invoices are in FreeAgent and how many tickets in ConnectWise PSA",  steps: [    { action: "freeagent.invoices.list", as: "inv", input: {}, limit: 100, max_pages: 5 },    { action: "connectwise_manage.tickets.list", as: "tix", input: {}, limit: 100, max_pages: 5 },    { join: {        left: "inv",        right: "tix",        on: "crm.company",        group_by: "inv.company_name",        select: ["inv.company_name", "count(inv.id) as invoices", "count(tix.id) as tickets"]    } }  ]}
Example. Run it through check first: it validates the steps and prices them, and it is free.

Governance for FreeAgent

Destructive actions wait for a yes.

27 FreeAgent actions are destructive. These are all of them:

  • Delete an invoicefreeagent.invoices.delete
  • Delete an estimatefreeagent.estimates.delete
  • Delete an expensefreeagent.expenses.delete
  • Delete a taskfreeagent.tasks.delete
  • Delete a projectfreeagent.projects.delete
  • Delete a billfreeagent.bills.delete
  • Delete a credit notefreeagent.credit_notes.delete
  • Delete a userfreeagent.users.delete
  • Delete a bank accountfreeagent.bank_accounts.delete
  • Delete a timeslipfreeagent.timeslips.delete
  • Delete a contactfreeagent.contacts.delete
  • Delete a journal setfreeagent.journal_sets.delete
  • Delete a price list itemfreeagent.price_list_items.delete
  • Delete a bank transactionfreeagent.bank_transactions.delete
  • Delete a notefreeagent.notes.delete
  • Delete a categoryfreeagent.categories.delete
  • Delete a propertyfreeagent.properties.delete
  • Delete a single attachmentfreeagent.attachments.delete
  • Delete the User Account Lockfreeagent.account_locks.delete
  • Delete an estimate itemfreeagent.estimate_items.delete
  • Delete a sales tax periodfreeagent.sales_tax_periods.delete
  • Delete a capital asset typefreeagent.capital_asset_types.delete
  • Delete a credit note reconciliationfreeagent.credit_note_reconciliations.delete
  • Delete a bank transaction explanationfreeagent.bank_transaction_explanations.delete
  • Stop a Timerfreeagent.timeslips.stop_timer
  • Delete default additional textfreeagent.invoices.default_additional_text_delete
  • Delete default additional textfreeagent.estimates.default_additional_text_delete

A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

dofreeagent.invoices.deleteconfirm_policy: human

Delete an invoice?

intent: the user asked me to delete an invoice

run suspended · waiting for a named person · key freeagent-agent cannot confirm itself
In the console, or from an emailed signed link.
a key for this connector
account {  op: "keys.create", name: "freeagent-agent",  allowed_actions: ["freeagent.*"], cap_calls: 2000,  confirm_policy: "human_for_writes",  approval_rules: [    { match: "freeagent.invoices.delete", approver: "[email protected]" },    { match: "freeagent.estimates.delete", approver: "[email protected]" },    { match: "freeagent.expenses.delete", approver: "[email protected]" }  ]}
Illustrative. Scoped to FreeAgent only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

What FreeAgent costs on actionlake.

Every FreeAgent action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call FreeAgent refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

  • 1upstream call per actionall 203 FreeAgent actions
  • 203actions pageeach page of a long list is one call
  • 93reads can be cacheda cache hit costs nothing
  • 100,000calls a month, freepaid plans from US$49 a month for 250,000

See pricing

Action index

Every FreeAgent action.

203 actions by area: the id your agent calls, what it does, and its effect.

Invoices18
  • freeagent.invoices.convert_to_credit_noteConvert to credit notewrite
  • freeagent.invoices.createCreate an invoicewrite
  • freeagent.invoices.default_additional_text_deleteDelete default additional textdestructive
  • freeagent.invoices.default_additional_text_getGet default additional textread
  • freeagent.invoices.default_additional_text_updateUpdate default additional textwrite
  • freeagent.invoices.deleteDelete an invoicedestructive
  • freeagent.invoices.duplicateDuplicate an invoicewrite
  • freeagent.invoices.getGet a single invoiceread
  • freeagent.invoices.get_pdfGet a single invoice as PDFread
  • freeagent.invoices.listList all invoicesread
  • freeagent.invoices.mark_as_cancelledMark invoice as cancelledwrite
  • freeagent.invoices.mark_as_draftMark invoice as draftwrite
  • freeagent.invoices.mark_as_scheduledMark invoice as scheduledwrite
  • freeagent.invoices.mark_as_sentMark invoice as sentwrite
  • freeagent.invoices.send_emailEmail an invoicewrite
  • freeagent.invoices.take_direct_debit_paymentTake Payment using GoCardless Direct Debit Mandatewrite
  • freeagent.invoices.timelineGet invoice timelineread
  • freeagent.invoices.updateUpdate an invoicewrite
Estimates16
  • freeagent.estimates.convert_to_invoiceConvert estimate to an invoicewrite
  • freeagent.estimates.createCreate an estimatewrite
  • freeagent.estimates.default_additional_text_deleteDelete default additional textdestructive
  • freeagent.estimates.default_additional_text_getGet default additional textread
  • freeagent.estimates.default_additional_text_updateUpdate default additional textwrite
  • freeagent.estimates.deleteDelete an estimatedestructive
  • freeagent.estimates.duplicateDuplicate an estimatewrite
  • freeagent.estimates.getGet a single estimateread
  • freeagent.estimates.get_pdfGet a single estimate as PDFread
  • freeagent.estimates.listList all estimatesread
  • freeagent.estimates.mark_as_approvedMark estimate as approvedwrite
  • freeagent.estimates.mark_as_draftMark estimate as draftwrite
  • freeagent.estimates.mark_as_rejectedMark estimate as rejectedwrite
  • freeagent.estimates.mark_as_sentMark estimate as sentwrite
  • freeagent.estimates.send_emailEmail an estimatewrite
  • freeagent.estimates.updateUpdate an estimatewrite
Credit notes9
  • freeagent.credit_notes.createCreate a credit notewrite
  • freeagent.credit_notes.deleteDelete a credit notedestructive
  • freeagent.credit_notes.getGet a single credit noteread
  • freeagent.credit_notes.get_pdfGet a single credit note as PDFread
  • freeagent.credit_notes.listList all credit notesread
  • freeagent.credit_notes.mark_as_draftMark credit note as draftwrite
  • freeagent.credit_notes.mark_as_sentMark credit note as sentwrite
  • freeagent.credit_notes.send_emailEmail a credit notewrite
  • freeagent.credit_notes.updateUpdate a credit notewrite
Timeslips7
  • freeagent.timeslips.createCreate a timeslipwrite
  • freeagent.timeslips.deleteDelete a timeslipdestructive
  • freeagent.timeslips.getGet a single timeslipread
  • freeagent.timeslips.listList all timeslipsread
  • freeagent.timeslips.start_timerStart a Timerwrite
  • freeagent.timeslips.stop_timerStop a Timerdestructive
  • freeagent.timeslips.updateUpdate a timeslipwrite
Users7
  • freeagent.users.createCreate a userwrite
  • freeagent.users.deleteDelete a userdestructive
  • freeagent.users.getGet a single userread
  • freeagent.users.listList all usersread
  • freeagent.users.meGet the personal profile of the authorised userread
  • freeagent.users.updateUpdate a userwrite
  • freeagent.users.update_meUpdate personal profilewrite
Corporation tax returns6
  • freeagent.corporation_tax_returns.getFetch details for a Corporation Tax Returnread
  • freeagent.corporation_tax_returns.listList Corporation Tax Returns for a companyread
  • freeagent.corporation_tax_returns.mark_as_filedMark a Corporation Tax Return as Filedwrite
  • freeagent.corporation_tax_returns.mark_as_paidMark a Corporation Tax Return as Paidwrite
  • freeagent.corporation_tax_returns.mark_as_unfiledMark a Corporation Tax Return as Unfiledwrite
  • freeagent.corporation_tax_returns.mark_as_unpaidMark a Corporation Tax Return as Unpaidwrite
Expenses6
  • freeagent.expenses.createCreate an expensewrite
  • freeagent.expenses.deleteDelete an expensedestructive
  • freeagent.expenses.getGet a single expenseread
  • freeagent.expenses.listList all expensesread
  • freeagent.expenses.mileage_settingsGet mileage settingsread
  • freeagent.expenses.updateUpdate an expensewrite
Journal sets6
  • freeagent.journal_sets.createCreate a journal setwrite
  • freeagent.journal_sets.deleteDelete a journal setdestructive
  • freeagent.journal_sets.getGet a single journal setread
  • freeagent.journal_sets.listList all journal setsread
  • freeagent.journal_sets.opening_balancesGet the Opening Balancesread
  • freeagent.journal_sets.updateUpdate a journal setwrite
Self assessment returns6
  • freeagent.self_assessment_returns.getFetch details for an Income Tax Returnread
  • freeagent.self_assessment_returns.listList Income Tax Returns for a Userread
  • freeagent.self_assessment_returns.mark_as_filedMark an Income Tax Return as Filedwrite
  • freeagent.self_assessment_returns.mark_as_unfiledMark an Income Tax Return as Unfiledwrite
  • freeagent.self_assessment_returns.mark_payment_as_paidMark an Income Tax Return Payment as Paidwrite
  • freeagent.self_assessment_returns.mark_payment_as_unpaidMark an Income Tax Return Payment as Unpaidwrite
Vat returns6
  • freeagent.vat_returns.getFetch details for a VAT Returnread
  • freeagent.vat_returns.listList VAT Returns for a Companyread
  • freeagent.vat_returns.mark_as_filedMark a VAT Return as Filedwrite
  • freeagent.vat_returns.mark_as_unfiledMark a VAT Return as Unfiledwrite
  • freeagent.vat_returns.mark_payment_as_paidMark a VAT Return Payment as Paidwrite
  • freeagent.vat_returns.mark_payment_as_unpaidMark a VAT Return Payment as Unpaidwrite
Bank accounts5
  • freeagent.bank_accounts.createCreate a bank accountwrite
  • freeagent.bank_accounts.deleteDelete a bank accountdestructive
  • freeagent.bank_accounts.getGet a single bank accountread
  • freeagent.bank_accounts.listList bank accountsread
  • freeagent.bank_accounts.updateUpdate a bank accountwrite
Bank transaction explanations5
  • freeagent.bank_transaction_explanations.createCreate a bank transaction explanationwrite
  • freeagent.bank_transaction_explanations.deleteDelete a bank transaction explanationdestructive
  • freeagent.bank_transaction_explanations.getGet a single bank transaction explanationread
  • freeagent.bank_transaction_explanations.listList all bank transaction explanationsread
  • freeagent.bank_transaction_explanations.updateUpdate a bank transaction explanationwrite
Bills5
  • freeagent.bills.createCreate a billwrite
  • freeagent.bills.deleteDelete a billdestructive
  • freeagent.bills.getGet a single billread
  • freeagent.bills.listList all billsread
  • freeagent.bills.updateUpdate a billwrite
Capital asset types5
  • freeagent.capital_asset_types.createCreate a capital asset typewrite
  • freeagent.capital_asset_types.deleteDelete a capital asset typedestructive
  • freeagent.capital_asset_types.getGet a single capital asset typeread
  • freeagent.capital_asset_types.listList all capital asset typesread
  • freeagent.capital_asset_types.updateUpdate a capital asset typewrite
Categories5
  • freeagent.categories.createCreate a categorywrite
  • freeagent.categories.deleteDelete a categorydestructive
  • freeagent.categories.getGet a single categoryread
  • freeagent.categories.listList all categoriesread
  • freeagent.categories.updateUpdate a categorywrite
Contacts5
  • freeagent.contacts.createCreate a contactwrite
  • freeagent.contacts.deleteDelete a contactdestructive
  • freeagent.contacts.getGet a single contactread
  • freeagent.contacts.listList all contactsread
  • freeagent.contacts.updateUpdate a contactwrite
Credit note reconciliations5
  • freeagent.credit_note_reconciliations.createCreate a credit note reconciliationwrite
  • freeagent.credit_note_reconciliations.deleteDelete a credit note reconciliationdestructive
  • freeagent.credit_note_reconciliations.getGet a single credit note reconciliationread
  • freeagent.credit_note_reconciliations.listList all credit note reconciliationsread
  • freeagent.credit_note_reconciliations.updateUpdate a credit note reconciliationwrite
Price list items5
  • freeagent.price_list_items.createCreate a price list itemwrite
  • freeagent.price_list_items.deleteDelete a price list itemdestructive
  • freeagent.price_list_items.getGet a single price list itemread
  • freeagent.price_list_items.listList all price list itemsread
  • freeagent.price_list_items.updateUpdate a price list itemwrite
Projects5
  • freeagent.projects.createCreate a projectwrite
  • freeagent.projects.deleteDelete a projectdestructive
  • freeagent.projects.getGet a single projectread
  • freeagent.projects.listList all projectsread
  • freeagent.projects.updateUpdate a projectwrite
Properties5
  • freeagent.properties.createCreate a propertywrite
  • freeagent.properties.deleteDelete a propertydestructive
  • freeagent.properties.getGet a single propertyread
  • freeagent.properties.listList all propertiesread
  • freeagent.properties.updateUpdate a propertywrite
Sales tax periods5
  • freeagent.sales_tax_periods.createCreate a sales tax periodwrite
  • freeagent.sales_tax_periods.deleteDelete a sales tax perioddestructive
  • freeagent.sales_tax_periods.getGet a single sales tax periodread
  • freeagent.sales_tax_periods.listList all sales tax periods for a companyread
  • freeagent.sales_tax_periods.updateUpdate a sales tax periodwrite
Tasks5
  • freeagent.tasks.createCreate a task under a projectwrite
  • freeagent.tasks.deleteDelete a taskdestructive
  • freeagent.tasks.getGet a single taskread
  • freeagent.tasks.listList all tasksread
  • freeagent.tasks.updateUpdate a taskwrite
Bank transactions4
  • freeagent.bank_transactions.deleteDelete a bank transactiondestructive
  • freeagent.bank_transactions.getGet a single bank transactionread
  • freeagent.bank_transactions.listList bank transactions in a bank accountread
  • freeagent.bank_transactions.upload_statementUpload a bank statementwrite
Final accounts reports4
  • freeagent.final_accounts_reports.getFetch details for a Final Accounts Reportread
  • freeagent.final_accounts_reports.listList Final Accounts Reports for a companyread
  • freeagent.final_accounts_reports.mark_as_filedMark a Final Accounts Report as Filedwrite
  • freeagent.final_accounts_reports.mark_as_unfiledMark a Final Accounts Report as Unfiledwrite
Notes4
  • freeagent.notes.createCreate a note for a contact or projectwrite
  • freeagent.notes.deleteDelete a notedestructive
  • freeagent.notes.getGet a single noteread
  • freeagent.notes.updateUpdate a notewrite
Payroll4
  • freeagent.payroll.get_periodList all payslips for a given periodread
  • freeagent.payroll.list_periodsList all periods for a given tax yearread
  • freeagent.payroll.mark_payment_as_paidMark a payment as paidwrite
  • freeagent.payroll.mark_payment_as_unpaidMark a payment as unpaidwrite
Account locks3
  • freeagent.account_locks.deleteDelete the User Account Lockdestructive
  • freeagent.account_locks.listList Account Locks for a companyread
  • freeagent.account_locks.upsertCreate or Update the User Account Lockwrite
Account managers3
  • freeagent.account_managers.getGet details of a single account managerread
  • freeagent.account_managers.listList account managersread
  • freeagent.account_managers.meGet the current account managerread
Company3
  • freeagent.company.business_categoriesList all business categoriesread
  • freeagent.company.getGeneral company informationread
  • freeagent.company.tax_timelineInformation about upcoming tax eventsread
Estimate items3
  • freeagent.estimate_items.createCreate an estimate itemwrite
  • freeagent.estimate_items.deleteDelete an estimate itemdestructive
  • freeagent.estimate_items.updateUpdate an estimate itemwrite
Accounting transactions2
  • freeagent.accounting_transactions.getGet a single transactionread
  • freeagent.accounting_transactions.listList all transactionsread
Attachments2
  • freeagent.attachments.deleteDelete a single attachmentdestructive
  • freeagent.attachments.getShow a single attachmentread
Balance sheet2
  • freeagent.balance_sheet.getGet the balance sheetread
  • freeagent.balance_sheet.opening_balancesGet the opening balancesread
Bank feeds2
  • freeagent.bank_feeds.getReading an API Bank Feedread
  • freeagent.bank_feeds.listReading the list of bank feeds for a companyread
Capital assets2
  • freeagent.capital_assets.getGet a single capital assetread
  • freeagent.capital_assets.listList all capital assetsread
Cis settings2
  • freeagent.cis_settings.getGet CIS settingsread
  • freeagent.cis_settings.updateUpdate CIS settingswrite
Hire purchases2
  • freeagent.hire_purchases.getGet a single hire purchaseread
  • freeagent.hire_purchases.listList all hire purchasesread
Recurring invoices2
  • freeagent.recurring_invoices.getGet a single recurring invoiceread
  • freeagent.recurring_invoices.listList all recurring invoicesread
Stock items2
  • freeagent.stock_items.getGet a single Stock Itemread
  • freeagent.stock_items.listList all Stock Itemsread
Trial balance2
  • freeagent.trial_balance.opening_balancesGet the opening balancesread
  • freeagent.trial_balance.summaryGet the trial balance summaryread
Cashflow1
  • freeagent.cashflow.getCashflow summary for a given date rangeread
Cis bands1
  • freeagent.cis_bands.listList all CIS bands for a companyread
Email addresses1
  • freeagent.email_addresses.listGet a list of verified sender email addressesread
Payroll profiles1
  • freeagent.payroll_profiles.listList payroll profiles for a tax yearread
Practice1
  • freeagent.practice.getGet details of accountancy practiceread
Practice clients1
  • freeagent.practice_clients.listList clientsread
Profit and loss1
  • freeagent.profit_and_loss.summaryGet the P&L summaryread
Sales tax1
  • freeagent.sales_tax.ec_moss_ratesEC VAT MOSSread

Questions

The FreeAgent MCP server, answered.

Is there a FreeAgent MCP server for Claude?

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 203 FreeAgent actions across invoices, estimates, credit notes and timeslips, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by FreeAgent.

What do I need to connect FreeAgent?

Your own FreeAgent OAuth app, registered with FreeAgent (its client id and client secret), and the access and refresh tokens from one admin sign-in. actionlake has no FreeAgent app of its own, so this is not a one-step consent. actionlake renews the access token as it expires. The free call account { op: "connections.requirements", service: "freeagent" } lists exactly what to paste.

Can an AI agent delete or change things in FreeAgent?

Only if its key allows it, and only with an explicit confirmation. 27 FreeAgent actions are destructive, including delete an invoice, delete an estimate and delete an expense. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

Will an AI agent use up my FreeAgent API limit?

actionlake paces every call to the limits in the FreeAgent service file: 120 calls a minute per connection. Repeated reads are answered from cache (93 FreeAgent actions can be), which never reaches FreeAgent.

What does a FreeAgent action cost?

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (203 FreeAgent actions page). Cache hits, searches, dry runs and calls FreeAgent refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

Which FreeAgent API does it cover?

The FreeAgent API v2 at api.freeagent.com/v2. It is built from FreeAgent's documentation as read on 23 October 2026. 203 actions in 48 areas, each one in the signed service file (version 1.0.0).

Can I combine FreeAgent with my other systems?

Yes. ask joins FreeAgent to ConnectWise PSA or HubSpot CRM on the same customer and returns the answer rather than every row. FreeAgent maps crm.company, which 227 other connectors also map.

Does actionlake keep my FreeAgent data, and where?

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your FreeAgent credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

Which AI clients can use it?

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

Give your agent FreeAgent today.

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.