Skip to main content
Glama
freeagent-mcp-server

freeagent-mcp-server

by samaxbytez

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FREEAGENT_SANDBOXNoSet to true for sandbox (defaults to production)
FREEAGENT_BASE_URLNoOverride API base URL
FREEAGENT_CLIENT_IDNoOAuth2 client ID from Developer Dashboard
FREEAGENT_ACCESS_TOKENNoDirect access token (skips stored token flow)
FREEAGENT_CLIENT_SECRETNoOAuth2 client secret from Developer Dashboard

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
freeagent_get_companyA

Get information about the authenticated FreeAgent company, including name, type, currency, and other settings.

freeagent_list_business_categoriesA

List the available business categories for the company. These are used to classify the type of business.

freeagent_get_tax_timelineA

Get the tax timeline for the company, showing upcoming tax deadlines and obligations.

freeagent_list_usersC

List all users in the FreeAgent account

freeagent_get_userC

Get a specific user by ID

freeagent_get_current_userA

Get the currently authenticated user

freeagent_list_contactsC

List contacts from FreeAgent with optional filtering and sorting

freeagent_get_contactB

Get a single contact from FreeAgent by ID

freeagent_create_contactA

Create a new contact in FreeAgent. Must provide either first_name and last_name, or organisation_name.

freeagent_update_contactC

Update an existing contact in FreeAgent

freeagent_delete_contactC

Delete a contact from FreeAgent

freeagent_list_projectsB

List projects from FreeAgent, optionally filtered by view, sort order, or contact

freeagent_get_projectB

Get a single project from FreeAgent by ID

freeagent_create_projectC

Create a new project in FreeAgent

freeagent_update_projectC

Update an existing project in FreeAgent

freeagent_delete_projectC

Delete a project from FreeAgent

freeagent_list_tasksA

List tasks from FreeAgent. Optionally filter by view, project, or updated_since.

freeagent_get_taskC

Get a specific task by ID from FreeAgent.

freeagent_create_taskB

Create a new task in FreeAgent. The project URL is required and passed as a query parameter.

freeagent_update_taskC

Update an existing task in FreeAgent.

freeagent_delete_taskC

Delete a task from FreeAgent.

freeagent_list_timeslipsB

List timeslips from FreeAgent. Can be filtered by date range, user, task, project, and billing status.

freeagent_get_timeslipB

Get a single timeslip by its ID.

freeagent_create_timeslipB

Create a new timeslip in FreeAgent for tracking time against a project task.

freeagent_update_timeslipC

Update an existing timeslip in FreeAgent.

freeagent_delete_timeslipC

Delete a timeslip from FreeAgent.

freeagent_start_timerA

Start a running timer on a timeslip. The timeslip will accumulate time until the timer is stopped.

freeagent_stop_timerB

Stop a running timer on a timeslip.

freeagent_list_invoicesB

List invoices from FreeAgent, optionally filtered by view, sort order, contact, project, or updated date

freeagent_get_invoiceA

Get a single invoice from FreeAgent by ID

freeagent_create_invoiceC

Create a new invoice in FreeAgent

freeagent_update_invoiceC

Update an existing invoice in FreeAgent

freeagent_delete_invoiceC

Delete an invoice from FreeAgent

freeagent_mark_invoice_as_sentC

Mark an invoice as sent in FreeAgent

freeagent_mark_invoice_as_draftC

Mark an invoice as draft in FreeAgent

freeagent_mark_invoice_as_cancelledC

Cancel an invoice in FreeAgent

freeagent_list_estimatesC

List estimates from FreeAgent with optional filtering

freeagent_get_estimateB

Get a single estimate from FreeAgent by ID

freeagent_create_estimateC

Create a new estimate in FreeAgent

freeagent_update_estimateC

Update an existing estimate in FreeAgent

freeagent_delete_estimateC

Delete an estimate from FreeAgent

freeagent_mark_estimate_as_sentC

Mark an estimate as sent in FreeAgent

freeagent_mark_estimate_as_approvedC

Mark an estimate as approved in FreeAgent

freeagent_list_billsB

List bills from FreeAgent with optional filtering by view, date range, contact, or project

freeagent_get_billC

Get a single bill from FreeAgent by ID

freeagent_create_billB

Create a new bill in FreeAgent. bill_items should be a JSON string array of objects with category (URL), description, total_value, and sales_tax_rate.

freeagent_update_billC

Update an existing bill in FreeAgent

freeagent_delete_billB

Delete a bill from FreeAgent

freeagent_list_credit_notesB

List credit notes from FreeAgent with optional filtering and sorting

freeagent_get_credit_noteA

Get a single credit note from FreeAgent by ID

freeagent_create_credit_noteC

Create a new credit note in FreeAgent

freeagent_update_credit_noteC

Update an existing credit note in FreeAgent

freeagent_delete_credit_noteB

Delete a credit note from FreeAgent

freeagent_list_expensesA

List expenses from FreeAgent with optional filtering by view, date range, and project

freeagent_get_expenseB

Get a single expense from FreeAgent by ID

freeagent_create_expenseC

Create a new expense in FreeAgent

freeagent_update_expenseC

Update an existing expense in FreeAgent

freeagent_delete_expenseB

Delete an expense from FreeAgent

freeagent_list_bank_accountsB

List bank accounts from FreeAgent with optional view filter

freeagent_get_bank_accountB

Get a single bank account from FreeAgent by ID

freeagent_update_bank_accountC

Update an existing bank account in FreeAgent

freeagent_delete_bank_accountC

Delete a bank account from FreeAgent

freeagent_list_bank_transactionsC

List bank transactions from FreeAgent for a specific bank account

freeagent_get_bank_transactionA

Get a single bank transaction from FreeAgent by ID

freeagent_list_categoriesB

List all categories from FreeAgent, optionally including sub-accounts

freeagent_get_categoryB

Get a single category from FreeAgent by nominal code

freeagent_get_profit_and_lossB

Get the profit and loss summary from FreeAgent with optional date range filtering

freeagent_get_balance_sheetB

Get the balance sheet from FreeAgent, optionally as at a specific date

freeagent_get_opening_balancesB

Get the opening balances from the FreeAgent balance sheet

freeagent_get_trial_balanceB

Get the trial balance summary from FreeAgent with optional date range filtering

freeagent_get_trial_balance_openingC

Get the trial balance opening balances from FreeAgent

freeagent_download_attachmentA

Download a FreeAgent attachment (e.g. an expense or bill receipt) into FREEAGENT_ATTACHMENTS_DIR. Takes the attachment ID from an attachment URL such as https://api.freeagent.com/v2/attachments/123. Never overwrites: a clashing name gets a ' (n)' suffix. Returns the saved path, not the download link.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3/5.0

Scored across 72 tools

Disambiguation5/5

Each tool maps to a distinct FreeAgent resource and action, with clear separation between invoices, estimates, expenses, bills, credit notes, contacts, projects, tasks, timeslips, bank accounts, transactions, and reports. Minor look-alikes such as list_categories vs list_business_categories are clarified by their descriptions.

Naming Consistency5/5

All tools use a consistent freeagent_ prefix followed by snake_case verb_noun naming such as get_invoice, create_task, update_project, and delete_bill. The few state-transition names like mark_invoice_as_sent also follow the same predictable pattern.

Tool Count1/5

With 72 tools, the server is far beyond a practical agent-sized surface and creates a heavy selection burden. Although the tools map to a broad accounting domain, the count is extreme enough to undermine coherence as a single MCP toolset.

Completeness3/5

Core accounting entities such as invoices, estimates, expenses, bills, contacts, projects, tasks, and timeslips have solid CRUD coverage, and reports are included. However, notable lifecycle gaps remain, especially around bank transactions, payments/reconciliation, user management, and attachment handling beyond download.

Maintenance

ActivityMaintained
ResponsivenessLimited data