Freeagent

io.usefulapiv1.0.0Updated Oct 7, 2026

Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant read FreeAgent accounting data and create contacts, draft invoices, and timeslips through a hosted OAuth connection.

What it does
Connects to a FreeAgent account and exposes read tools for the company, current user, tax timeline, contacts, invoices, bills, expenses, bank accounts and transactions, projects, tasks, timeslips, profit and loss, and the balance sheet. Write tools create and update contacts, create draft invoices that are never sent, and log timeslips. Meta tools report usage and manage a paid subscription.
When to use it
Useful when an assistant needs to answer questions about FreeAgent books or draft simple records without opening the FreeAgent web app. It suits freelancers and small businesses already using FreeAgent who want conversational access to invoices, expenses, banking, and reports.
Requirements
A remote MCP endpoint at no local install. A FreeAgent account signed in and approved over OAuth on first connect; no API keys to paste. Network access required. Free tier is limited to 100 tool calls per month.
Before you install
Write tools create or update contacts, draft invoices, and timeslips, so confirm them before running. The server acts with the permissions of the signed-in FreeAgent user and never deletes anything; access can be revoked in FreeAgent under Settings, Approved apps. Paid Pro is $9 per month or $90 per year, billed through a Stripe Checkout link; cancelling gives no refund for the current period. Usage is metered and reported by a meta tool.

Installation

In SourceWeft

  1. Open Freeagent in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "freeagent": {
      "type": "http",
      "url": "https://freeagent.usefulapi.io/mcp"
    }
  }
}

README

FreeAgent MCP by usefulapi

Work with your FreeAgent books from Claude, Cursor, or any MCP client — read contacts, invoices, bills, expenses, bank accounts and transactions, projects, timeslips, the tax timeline, profit and loss and the balance sheet; create and update contacts, create draft invoices (never sent) and log timeslips. Hosted, no local install: connect with your FreeAgent account over OAuth.

Live endpoint: https://freeagent.usefulapi.io/mcp · Homepage: https://usefulapi.io/freeagent

Add to Claude

json
{  "mcpServers": {    "freeagent": {      "url": "https://freeagent.usefulapi.io/mcp"    }  }}

On first connect you'll be sent to FreeAgent to sign in and approve access; no API keys to paste. The server can do only what your FreeAgent user is allowed to do, it never deletes anything, and you can revoke access any time in FreeAgent (Settings → Approved apps).

Tools

ToolTypeWhat it does
freeagent_get_companyreadGet the company
freeagent_get_current_userreadGet the current user
freeagent_get_tax_timelinereadGet the tax timeline
freeagent_list_contactsreadList contacts
freeagent_get_contactreadGet one contact
freeagent_list_invoicesreadList invoices
freeagent_get_invoicereadGet one invoice
freeagent_list_billsreadList bills
freeagent_list_expensesreadList expenses
freeagent_list_bank_accountsreadList bank accounts
freeagent_list_bank_transactionsreadList bank transactions
freeagent_list_projectsreadList projects
freeagent_list_tasksreadList tasks
freeagent_list_timeslipsreadList timeslips
freeagent_get_profit_and_lossreadGet profit and loss
freeagent_get_balance_sheetreadGet the balance sheet
freeagent_create_contactwriteCreate a contact
freeagent_update_contactwriteUpdate a contact
freeagent_create_draft_invoicewriteCreate a draft invoice
freeagent_create_timeslipwriteLog a timeslip
freeagent_usage_statusmetaUsage status (free-tier meter)
freeagent_upgrademetaUpgrade to Pro (unlimited)
freeagent_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage or manage your subscription.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

Pro covers this server only. Subscribe with freeagent_upgrade (it returns a Stripe Checkout link). Cancel any time with freeagent_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running freeagent_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. This repo contains documentation only; the server is hosted.

Source: servers/freeagent/README.md at commit 1142bfb

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 7, 2026