How to connect Freeagent to Claude

Connect Claude Web, Desktop and Cowork to Freeagent MCP. List overdue invoices for this month, create a new expense for office supplies, and more using natural language, with authentication handled for you.

Freeagent logoFreeagent
Oauth2

Freeagent is a cloud-based accounting platform designed for freelancers and small businesses. It simplifies bookkeeping, invoicing, and expense management in one place.

107 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Freeagent account to Claude via Composio Connect, enabling it to list overdue invoices for this month, create a new expense for office supplies, summarize all unassigned transactions, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

You can also connect Claude to multiple Freeagent accounts with Composio.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Freeagent with

Connecting Freeagent to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Freeagent account

Back in Claude, ask it to connect to Freeagent or give it any Freeagent-related task.

For example, ask Claude to:

  • "List overdue invoices for this month"
  • "Create a new expense for office supplies"
  • "Summarize all unassigned transactions"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Freeagent account is ready to use.

What is the Freeagent Claude Connector, and what's possible with it?

The Freeagent MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Freeagent account. It provides structured and secure access to your accounting records, so your agent can create invoices, record timeslips, review expenses, monitor cash flow, and track tax deadlines on your behalf.

  • Invoices, estimates, and credit notes: Have your agent create invoices, estimates, and credit notes, convert estimates into invoices, or convert eligible invoices into credit notes.
  • Financial reporting: Let the agent retrieve cash flow, profit and loss, trial balance, balance sheet, opening balance, and accounting transaction details for your business.
  • Expenses, bills, and banking: Direct your agent to list or update expenses, create bills with attachments, review bills and bank transactions, or create and list bank accounts.
  • Contacts, projects, and time tracking: Instruct your agent to create contacts and projects, review existing records, and add timeslips for completed work.
  • Tax and VAT planning: Have your agent list VAT returns and check your company tax timeline for upcoming events and deadlines.

Troubleshooting

1. Why does Claude not use the Composio connector for Freeagent?

The connector can show as connected, but Claude must use it in each Freeagent conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Freeagent again.

2. Why does Claude show an MCP server error before Freeagent connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Freeagent.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Freeagent.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Freeagent authorization link not work?

The Composio connector is one server. Your Freeagent account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Freeagent connection.
  • Composio creates a fresh Freeagent authorization link.
  • Open that link in your browser and finish the Freeagent sign-in.

4. Why do Freeagent actions fail after they worked before?

The Freeagent connection can expire or lose permission.

  • Ask Claude to inspect the Freeagent connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Freeagent account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Freeagent.
  • If the action still fails with a permission error, check that the connected account has that permission in Freeagent itself.

5. How do I switch to a different Freeagent account?

Claude can manage the Freeagent connection for you.

  • Ask Claude to disconnect or delete the current Freeagent account.
  • Ask Claude to connect Freeagent again.
  • Open the new Composio authorization link for Freeagent.
  • Sign in with the other Freeagent account in the browser.
  • After the account connects, ask Claude to retry the Freeagent task.

6. Why is my Freeagent connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Freeagent connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Freeagent tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Freeagent.
TOOLS

Supported Tools

Every Freeagent action and event your agent gets out of the box.

Cashflow summary for a date range

Tool to retrieve cashflow summary for a given date range from FreeAgent.

Get Company Details

Tool to retrieve company details from FreeAgent.

Create a Journal Set

Tool to create a journal set in FreeAgent.

Create Sales Tax Period

Tool to create a sales tax period in FreeAgent.

Create Task Under Project

Tool to create a task under a specific project in FreeAgent.

Create A Timeslip

Tool to create a new timeslip in FreeAgent.

Create a User

Tool to create a new user in FreeAgent.

Create Bank Account

Tool to create a bank account in FreeAgent.

Create Bill with Attachment

Tool to create a bill with optional attachment in FreeAgent.

Create Category

Tool to create a custom category in FreeAgent.

Create Contact

Tool to create a new contact in FreeAgent.

Create Credit Note

Tool to create a credit note in FreeAgent.

Create Credit Note Reconciliation

Tool to create a credit note reconciliation in FreeAgent.

Create Estimate

Tool to create a new estimate in FreeAgent.

Create Estimate Item

Tool to create an estimate item in FreeAgent.

Duplicate Estimate

Tool to duplicate an existing estimate in FreeAgent.

Send Estimate Email

Tool to email an estimate in FreeAgent.

Create Expense

Create a single standard or mileage expense in FreeAgent.

Create Invoice

Tool to create an invoice in FreeAgent.

Create Invoice Item

Tool to create an invoice item in FreeAgent.

Duplicate Invoice

Tool to duplicate an existing invoice in FreeAgent.

Create Note

Tool to create a note for a contact or project in FreeAgent.

Create Price List Item

Tool to create a price list item in FreeAgent.

Create Project

Tool to create a project in FreeAgent.

Delete Attachment

Permanently delete a FreeAgent attachment by its numeric ID.

Delete Bank Transaction Explanation

Tool to delete a bank transaction explanation in FreeAgent.

Delete Bill

Delete a bill by its FreeAgent identifier.

Delete Contact

Permanently delete a FreeAgent contact by ID.

Delete Estimate Item

Delete one line item from a FreeAgent estimate.

Delete Estimates Default Additional Text

Tool to delete default additional text for estimates in FreeAgent.

Delete Expense

Delete an expense by its FreeAgent identifier.

Delete Invoice

Permanently delete a FreeAgent invoice by ID.

Delete Journal Set

Delete a tagged FreeAgent journal set by its numeric ID.

Delete Note

Tool to delete a note by its ID.

Get Attachment

Retrieve any attachment's metadata and expiring content URLs by numeric ID.

Get Bill

Retrieve one FreeAgent bill by ID, including its line items and attachment metadata.

Get Category

Retrieve one FreeAgent accounting category by nominal code.

Get Contact

Retrieve one FreeAgent contact by its numeric ID.

Get Credit Note

Retrieve one FreeAgent credit note by its numeric ID, including line items.

Get Estimate

Retrieve one FreeAgent estimate by ID, including its estimate items.

Get Estimate Item

Retrieve one FreeAgent estimate line item by ID.

Get Expense

Retrieve one FreeAgent expense by ID, including its receipt attachment.

Get Invoice

Retrieve one FreeAgent invoice by its numeric ID, including line items.

Get Invoice Timeline

Tool to retrieve invoice timeline showing chronological record of invoice-related events.

Get Journal Set

Retrieve one FreeAgent journal set and its journal entries by numeric ID.

Get Mileage Settings

Tool to retrieve mileage settings including engine type/size options and reimbursement rates.

Get Opening Balances

Tool to retrieve the Opening Balances journal set for a company.

Get Personal Profile

Tool to retrieve the authenticated user's personal profile from FreeAgent.

Get Price List Item

Retrieve one FreeAgent price-list item by ID.

Get Project

Retrieve one FreeAgent project by its numeric ID.

Get the Opening Balances

Tool to retrieve the opening balances from the trial balance summary.

Get the P&L summary

Tool to retrieve the Profit and Loss summary for a specified period from FreeAgent.

Get Trial Balance Summary

Tool to get the trial balance summary from FreeAgent.

Get Balance Sheet

Tool to retrieve the balance sheet for a FreeAgent account.

Get Opening Balances

Tool to retrieve opening balances for the balance sheet from FreeAgent.

List Accounting Transactions

List a page of FreeAgent accounting transactions, optionally filtered by date range or nominal code.

List All CIS Bands

Tool to list all CIS (Construction Industry Scheme) bands for a company.

List All Expenses

List a page of FreeAgent expenses, optionally filtered by view type, date range, project, or last update timestamp.

List All Price List Items

List a page of FreeAgent price list items, optionally sorted by creation date, code, or update date.

List All Properties

Tool to list all properties in FreeAgent.

List All Recurring Invoices

Tool to retrieve a list of recurring invoices from FreeAgent.

List All Sales Tax Periods

Tool to list all sales tax periods for a company in FreeAgent.

List All Stock Items

List a page of FreeAgent stock items, with optional sorting by creation date, description, or update date and pagination controls.

List All Tasks

List a page of FreeAgent tasks with optional filtering by status, project, or update date, sorting, and pagination controls.

List All Timeslips

List a page of FreeAgent timeslips, with optional filtering by date range, user, project, task, billing status, or last update timestamp and pagination controls.

List All Users

Tool to list users in FreeAgent.

List Bank Accounts

Tool to list bank accounts in FreeAgent.

List Bank Feeds

Tool to list all bank feeds for a company.

List Bank Transaction Explanation Attachments

List file attachments for a FreeAgent bank transaction explanation.

List Bank Transactions

List a page of bank transactions for a specified FreeAgent bank account.

List Bills

Tool to retrieve a list of bills from FreeAgent.

List Business Categories

Tool to retrieve all available business categories from FreeAgent.

List Categories

Tool to retrieve all categories for the current FreeAgent company.

List Contacts

Tool to list contacts in FreeAgent.

List Credit Note Reconciliations

List a page of FreeAgent credit note reconciliations, optionally filtered by update timestamp or date range.

List Credit Notes

List FreeAgent credit notes with optional filtering by contact, project, status, or update time.

List EC MOSS Sales Tax Rates

Tool to retrieve EC VAT MOSS sales tax rates for a specific EU country and date.

List Estimates

Tool to list estimates in FreeAgent.

Get Default Estimates Additional Text

Tool to retrieve the default additional text for estimates.

List Final Accounts Reports

Tool to list final accounts reports for a company in FreeAgent.

List Hire Purchases

Tool to retrieve all hire purchases for the authorized FreeAgent account.

List Invoices

List ordinary FreeAgent invoices with filters and optional nested line items.

Get Default Additional Text

Tool to get the default additional text shown on all invoices.

List Notes

List notes for a specific contact or project, with pagination.

List Projects

Tool to list projects in FreeAgent.

List VAT Returns

Tool to list VAT returns for a company in FreeAgent.

Mark Invoice as Draft

Return a sent FreeAgent invoice to draft status.

Mark Invoice as Sent

Mark a draft invoice as sent without emailing it, or reopen a cancelled one.

Send Invoice Email

Email an existing invoice using explicit fields or an account template.

Show Tax Timeline

Tool to retrieve the company's tax timeline showing upcoming tax events and deadlines.

Update Bank Transaction Explanation

Tool to update a bank transaction explanation in FreeAgent.

Update Bill

Update a bill and create, update, or delete its line items.

Update Contact

Update mutable identity, contact, address, invoicing, and CIS fields.

Update Estimate Item

Update editable fields on an existing FreeAgent estimate item.

Update Estimates Default Additional Text

Tool to update the default additional text for estimates in FreeAgent.

Convert Estimate to Invoice

Tool to convert an estimate to an invoice in FreeAgent.

Update Expense

Tool to update an existing expense in FreeAgent.

Update Invoice

Update an invoice, including adding, changing, or deleting its line items.

Update Invoice Item

Update an existing invoice line item by its direct identifier.

Update Invoices Default Additional Text

Tool to update the default additional text shown on all invoices.

Convert Invoice to Credit Note

Tool to convert a draft negative invoice to a credit note in FreeAgent.

Update a Journal Set

Update a FreeAgent journal set's description, date, tag, or entries, including adding, modifying, or removing entries.

Update Note

Tool to update an existing note in FreeAgent.

Update Price List Item

Tool to update a price list item in FreeAgent.

Update Project

Update selected attributes of an existing FreeAgent project.

Update Personal Profile

Tool to update the authenticated user's personal profile in FreeAgent.

Upload a Bank Statement

Tool to upload a bank statement to FreeAgent.

FAQ

Frequently asked questions

Start with Freeagent.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Freeagent tool your agent needs.Free to start.

Start building