# FreeAgent MCP by usefulapi

> FreeAgent MCP by usefulapi is an MCP server. Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/freeagent/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/freeagent
- **MCP Registry name:** io.usefulapi/freeagent
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://freeagent.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `freeagent_get_company`: 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_current_user`: 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_tax_timeline`: List upcoming tax deadlines and amounts due — VAT returns, corporation tax, self assessment and so on. FreeAgent: GET /v2/company/tax_timeline.
- `freeagent_list_contacts`: List contacts (clients and suppliers), with their account balance. FreeAgent: GET /v2/contacts.
- `freeagent_get_contact`: Fetch a single contact by id or URL. FreeAgent: GET /v2/contacts/:id.
- `freeagent_list_invoices`: List sales invoices, optionally for one contact or project, filtered by status. FreeAgent: GET /v2/invoices.
- `freeagent_get_invoice`: Fetch a single invoice by id or URL, with its line items, totals, due and paid values. FreeAgent: GET /v2/invoices/:id.
- `freeagent_list_bills`: List supplier bills (purchases), optionally by date range, contact or project, filtered by status. FreeAgent: GET /v2/bills.
- `freeagent_list_expenses`: List expense claims (out-of-pocket spending and mileage), optionally by date range or project. FreeAgent: GET /v2/expenses.
- `freeagent_list_bank_accounts`: 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`: 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_projects`: List projects, optionally for one contact. FreeAgent: GET /v2/projects.
- `freeagent_list_tasks`: 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`: List logged time, optionally by date range, user, task or project; view=unbilled for time not yet invoiced. FreeAgent: GET /v2/timeslips.
- `freeagent_get_profit_and_loss`: 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_balance_sheet`: Balance sheet — capital and current assets, liabilities and owners' equity — as at a date (default today). FreeAgent: GET /v2/accounting/balance_sheet.
- `freeagent_create_contact`: Create a client or supplier contact. Give either organisation_name, or first_name and last_name. FreeAgent: POST /v2/contacts.
- `freeagent_update_contact`: Update fields on an existing contact; only the fields you pass change. status=Hidden hides it (reversible with Active). FreeAgent: PUT /v2/contacts/:id.
- `freeagent_create_draft_invoice`: 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`: 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.

## FAQ

### How do I add FreeAgent MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http freeagent https://freeagent.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/freeagent-mcp-by-usefulapi
