MCP server

FreeAgent MCP by usefulapi

io.usefulapi/freeagent

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

20

Token cost

About 5,744 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http freeagent https://freeagent.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.freeagent]
url = "https://freeagent.usefulapi.io/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add freeagent https://freeagent.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"freeagent","server_url":"https://freeagent.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"freeagent","server_url":"https://freeagent.usefulapi.io/mcp"}

Tools

• freeagent_create_contact ~501 tokens
  Create a client or supplier contact. Give either organisation_name, or first_name and last_name. FreeAgent: POST /v2/contacts.
• freeagent_create_draft_invoice ~698 tokens
  Create a sales invoice in DRAFT status. Nothing is sent to the customer and nothing is posted as income until it is marked sent in FreeAgent; a draft can be edited or discarded there. FreeAgent: POST /v2/invoices.
• freeagent_create_timeslip ~278 tokens
  Log time against a project task for a user. Get the user from freeagent_get_current_user and the task from freeagent_list_tasks. Editable or removable in FreeAgent afterwards. FreeAgent: POST /v2/timeslips.
• freeagent_get_balance_sheet ~122 tokens
  Balance sheet — capital and current assets, liabilities and owners' equity — as at a date (default today). FreeAgent: GET /v2/accounting/balance_sheet.
• freeagent_get_company ~105 tokens
  Fetch the FreeAgent company these credentials belong to — name, type (e.g. UkLimitedCompany), currency, start date and VAT registration status. A cheap way to confirm the setup works. FreeAgent: GET /v2/company.
• freeagent_get_contact ~97 tokens
  Fetch a single contact by id or URL. FreeAgent: GET /v2/contacts/:id.
• freeagent_get_current_user ~90 tokens
  Fetch the FreeAgent user the token acts as, including their URL (needed for freeagent_create_timeslip) and permission level. FreeAgent: GET /v2/users/me.
• freeagent_get_invoice ~111 tokens
  Fetch a single invoice by id or URL, with its line items, totals, due and paid values. FreeAgent: GET /v2/invoices/:id.
• freeagent_get_profit_and_loss ~206 tokens
  Profit and loss summary — income, expenses, operating and retained profit — for a date range or an accounting period (defaults to the current year to date). FreeAgent: GET /v2/accounting/profit_and_loss/summary.
• freeagent_get_tax_timeline ~87 tokens
  List upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on. FreeAgent: GET /v2/company/tax_timeline.
• freeagent_list_bank_accounts ~134 tokens
  List bank, credit-card and PayPal accounts with their current balances. Use an account's URL with freeagent_list_bank_transactions. FreeAgent: GET /v2/bank_accounts.
• freeagent_list_bank_transactions ~379 tokens
  List the transactions on one bank account, e.g. view=unexplained for what still needs reconciling. FreeAgent: GET /v2/bank_transactions?bank_account=….
• freeagent_list_bills ~390 tokens
  List supplier bills (purchases), optionally by date range, contact or project, filtered by status. FreeAgent: GET /v2/bills.
• freeagent_list_contacts ~285 tokens
  List contacts (clients and suppliers), with their account balance. FreeAgent: GET /v2/contacts.
• freeagent_list_expenses ~308 tokens
  List expense claims (out-of-pocket spending and mileage), optionally by date range or project. FreeAgent: GET /v2/expenses.
• freeagent_list_invoices ~415 tokens
  List sales invoices, optionally for one contact or project, filtered by status. FreeAgent: GET /v2/invoices.
• freeagent_list_projects ~283 tokens
  List projects, optionally for one contact. FreeAgent: GET /v2/projects.
• freeagent_list_tasks ~289 tokens
  List project tasks with their billing rates, optionally for one project. A task's URL is needed for freeagent_create_timeslip. FreeAgent: GET /v2/tasks.
• freeagent_list_timeslips ~397 tokens
  List logged time, optionally by date range, user, task or project; view=unbilled for time not yet invoiced. FreeAgent: GET /v2/timeslips.
• freeagent_update_contact ~569 tokens
  Update fields on an existing contact; only the fields you pass change. status=Hidden hides it (reversible with Active). FreeAgent: PUT /v2/contacts/:id.

Browse

• PayPal tools
• Payments
• Invoicing and accounting
• Stocks and markets

Related MCP servers

• Papierkram MCP by usefulapi
  Read Papierkram invoices, vouchers, contacts, projects, time; create contacts, time, draft invoices.
• bexio MCP by usefulapi
  Read bexio contacts, invoices, quotes, bills, projects and journal; log time, draft invoices.
• Lawcus MCP by usefulapi
  Read Lawcus contacts, matters, leads, time and billing reports; create contacts and tasks.
• Billy MCP by usefulapi
  Read Billy invoices, bills, contacts, products and postings; create contacts and draft invoices.
• ChargeOver MCP by usefulapi
  Read ChargeOver customers, invoices, transactions, subscriptions, reports; create customers, quotes.
• Lovie Company Formation
  Form companies, manage bank accounts, cards, invoices and more — directly from your AI coding tools.
• Billomat MCP by usefulapi
  Read Billomat clients, invoices, offers, credit notes, reminders; create clients and draft invoices.
• KashFlow MCP by usefulapi
  Read KashFlow invoices, customers, suppliers, banking and reports; add customers, notes.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/freeagent.svg)](https://aptlynx.net/servers/io.usefulapi/freeagent)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents