Freeagent MCP server

Connect Freeagent to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Freeagent MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list users tool in Freeagent
  • Use the create timeslip tool in Freeagent
  • Use the list bank accounts tool in Freeagent
  • Use the trial balance report tool in Freeagent
  • Use the list bills tool in Freeagent
  • Use the update invoice tool in Freeagent

Supported Tools

list_users

List Users

Retrieve users from the FreeAgent account. Can filter by role (staff, advisors, etc.).

create_timeslip

Create Timeslip

Log a time entry (timeslip) in FreeAgent against a task and user. Requires the task, user, date, and hours.

list_bank_accounts

List Bank Accounts

Retrieve bank accounts from FreeAgent. Optionally filter by account type (standard, credit card, PayPal).

get_trial_balance

Trial Balance Report

Retrieve the Trial Balance summary from FreeAgent, listing all categories with their balances for a given date range.

list_bills

List Bills

Retrieve supplier bills from FreeAgent. Supports filtering by status, date range, contact, or project.

update_invoice

Update Invoice

Update an existing invoice in FreeAgent. Use status transitions to change invoice status (mark as sent, cancelled, draft, or scheduled). Only the provided fields will be modified.

create_contact

Create Contact

Create a new contact in FreeAgent. Provide either an organisation name, or first and last name, or both.

list_expenses

List Expenses

Retrieve expenses from FreeAgent with optional filtering by date range, project, or view type (recent, recurring).

list_credit_notes

List Credit Notes

Retrieve credit notes from FreeAgent with optional filtering by status, contact, or project.

create_expense

Create Expense

Record a new business expense in FreeAgent. Requires user, category, date, and gross value. Can be linked to a project.

create_bill

Create Bill

Create a new supplier bill in FreeAgent. Requires a contact, reference, date, due date, and at least one line item.

list_bank_transactions

List Bank Transactions

Retrieve bank transactions for a specific bank account in FreeAgent. Can filter by date range and explanation status.

get_company

Get Company

Retrieve company information from FreeAgent including name, type, currency, start dates, and tax settings.

list_invoices

List Invoices

Retrieve invoices from FreeAgent with filtering by status, contact, project, and date. Can optionally include nested line items.

delete_expense

Delete Expense

Permanently delete an expense from FreeAgent. This cannot be undone.

update_project

Update Project

Update an existing project in FreeAgent. Only the provided fields will be changed.

list_tasks

List Tasks

Retrieve tasks from FreeAgent. Tasks are billable activities that belong to projects and can have timeslips logged against them.

update_timeslip

Update Timeslip

Update an existing time entry in FreeAgent. Can also start or stop a running timer on the timeslip.

delete_invoice

Delete Invoice

Permanently delete an invoice from FreeAgent. This cannot be undone.

get_contact

Get Contact

Retrieve a single contact by ID, including all details such as address, billing preferences, and project counts.

delete_contact

Delete Contact

Permanently delete a contact from FreeAgent. This action cannot be undone.

create_task

Create Task

Create a new task within a FreeAgent project. Tasks define billable activities that can have timeslips logged against them.

update_contact

Update Contact

Update an existing contact's details in FreeAgent. Only the provided fields will be changed.

delete_project

Delete Project

Permanently delete a project from FreeAgent. Only deletable projects can be removed.

delete_timeslip

Delete Timeslip

Permanently delete a timeslip (time entry) from FreeAgent.

list_contacts

List Contacts

Retrieve a list of contacts (customers, suppliers, etc.) from FreeAgent. Supports filtering by status, sorting, and pagination.

create_estimate

Create Estimate

Create a new estimate (quote) in FreeAgent for a contact. Estimates can later be converted to invoices.

list_timeslips

List Timeslips

Retrieve time tracking entries (timeslips) from FreeAgent. Can filter by date range, user, task, project, or billing status.

create_invoice

Create Invoice

Create a new draft invoice in FreeAgent. Requires a contact ID and date. Optionally include line items, payment terms, and other invoice details. Invoices are always created in Draft status.

list_estimates

List Estimates

Retrieve estimates from FreeAgent. Can filter by contact, project, or include nested line items.

get_balance_sheet

Balance Sheet Report

Retrieve the Balance Sheet report from FreeAgent. Returns capital assets, current assets, current liabilities, net current assets, and owner's equity as at a specific date.

get_profit_and_loss

Profit & Loss Report

Retrieve the Profit & Loss summary report from FreeAgent for a given date range. Returns income, expenses, operating profit, deductions, and retained profit. Date range must be within 12 months or a single accounting year.

list_categories

List Categories

Retrieve the chart of accounts (categories) from FreeAgent. Returns Admin Expenses, Cost of Sales, Income, and General categories. Optionally include sub-accounts.

get_invoice

Get Invoice

Retrieve a single invoice by ID with full details including line items, status, and payment information.

update_expense

Update Expense

Update an existing expense in FreeAgent. Only the provided fields will be changed.

list_projects

List Projects

Retrieve projects from FreeAgent with optional filtering by status or contact.

email_invoice

Email Invoice

Send an invoice to a recipient via email. The invoice must exist and have a valid status. You can customise the email subject, body, and recipients, or use the saved email template.

create_project

Create Project

Create a new project in FreeAgent linked to a contact. Projects can track time, expenses, and invoices for a client engagement.

download_invoice_pdf

Download Invoice PDF

Download the PDF for a FreeAgent invoice.

get_current_user

Get Current User

Retrieve the FreeAgent user who authorized this connection, including their profile URL, email, role, and permission level.

Connect Freeagent to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Freeagent in Metorial. In your Metorial portal, enable the Freeagent MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Freeagent tools.

Run Freeagent through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Freeagent and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Freeagent tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Freeagent

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Harvest

Track time, manage projects, clients, tasks, users, expenses, invoices, and estimates. Discover authorized accounts and your current profile, browse business records, generate structured reports, email invoices, and record invoice lifecycle events.

Apaleo

Manage hotel and serviced apartment operations through a cloud-based property management system (PMS). Create, modify, cancel, and manage reservations and bookings, including check-in, check-out, no-show handling, and room assignments. Manage property inventory including units (rooms), unit groups (room types), and unit attributes. Set up and update rate plans, rates, restrictions, and availability in real-time. Handle guest folios by posting charges, payments, refunds, and allowances, and move items between folios. Create, cancel, and render invoices as PDFs. Process payments via terminals and pay-by-link, manage payment authorizations, and track transaction lifecycles including settlements, refunds, and disputes. Manage company profiles for corporate bookings. Handle group bookings and room blocks with confirmation, release, and wash operations. Subscribe to ARI (Availability, Rates, Inventory) change notifications for channel distribution. Configure property settings, services, and city taxes. Trigger night audit operations. Manage account users. Retrieve reports and accounting transaction data.

Technical notes for Freeagent

Manage FreeAgent contacts, invoices, estimates, supplier bills, expenses, projects, tasks, and timeslips. Browse bank accounts and transactions, identify the connected user, download invoice PDFs, and retrieve financial reports.

Frequently asked questions

Common questions about connecting Freeagent to AI agents with Metorial.

  1. How many tools does the Freeagent MCP server have?
    The Freeagent MCP server exposes 40 tools, including List Users, Create Timeslip, List Bank Accounts. Each one is governed and traced through Metorial.
  2. Freeagent exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Freeagent MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Freeagent and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Freeagent MCP server yourself or use the hosted gateway.

Connect Freeagent to production AI agents

See how Metorial gives your team governed access to Freeagent, with tracing and security controls built in.