MCP server
FreeAgent MCP by usefulapi
Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft…
- Runs
- Remotely
- Version
- 1.33.0
- Listing updated
- 4 days ago
About FreeAgent MCP by usefulapi
FreeAgent MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read FreeAgent contacts, invoices, bills, banking and reports; add contacts, draft invoices, time.
Install
Run in a terminal
claude mcp add --transport http freeagent https://freeagent.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://freeagent.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"freeagent": {
"url": "https://freeagent.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"freeagent": {
"type": "http",
"url": "https://freeagent.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"freeagent": {
"serverUrl": "https://freeagent.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"freeagent": {
"type": "http",
"url": "https://freeagent.usefulapi.io/mcp"
}
}
}Tools this server provides (20)
Read directly from the server.
- 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.
FreeAgent MCP by usefulapi 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