A Model Context Protocol (MCP) server for the FreeAgent accounting API. Enables LLMs to manage contacts, invoices, estimates, bills, expenses, timeslips, projects, tasks, bank accounts, and more.
概览
A Model Context Protocol (MCP) server for the FreeAgent accounting API. Enables LLMs to manage contacts, invoices, estimates, bills, expenses, timeslips, projects, tasks, bank accounts, and more. By my own admission, most of this project is vibe coded. - : contacts, invoices (incl. transitions, email, duplicate, direct debit), estimates, bills, recurring invoices, price list items, expenses, timeslips, projects, tasks, bank accounts/feeds/statements (JSON lines), credit notes + reconciliations, notes, attachments (metadata), journals, capital assets, accounting reports (P&L, balance sheet, trial balance, cashflow, ledger), VAT/corp tax/income tax/final accounts, payroll, properties/stock/hire purchases, CIS, sales tax periods, account locks, categories, company info, and users - : reconcile_bank_transaction, log_expense, and invoice_from_timeslips collapse multi-call sequences into single tool calls and resolve human-friendly hints (names, codes, references) to FreeAgent URLs...
README
以下为原文 README 节选，完整内容请查看原文。
FreeAgent MCP Server
A Model Context Protocol (MCP) server for the FreeAgent accounting API. Enables LLMs to manage contacts, invoices, estimates, bills, expenses, timeslips, projects, tasks, bank accounts, and more.
By my own admission, most of this project is vibe coded.
Features
- Broad FreeAgent coverage: contacts, invoices (incl. transitions, email, duplicate, direct debit), estimates, bills, recurring invoices, price list items, expenses, timeslips, projects, tasks, bank accounts/feeds/statements (JSON lines), credit notes + reconciliations, notes, attachments (metadata), journals, capital assets, accounting reports (P&L, balance sheet, trial balance, cashflow, ledger), VAT/corp tax/income tax/final accounts, payroll, properties/stock/hire purchases, CIS, sales tax periods, account locks, categories, company info, and users
- Intent-bundle tools:
reconcile_bank_transaction,log_expense, andinvoice_from_timeslipscollapse multi-call sequences into single tool calls and resolve human-friendly hints (names, codes, references) to FreeAgent URLs server-side - Tool-search mode (
FREEAGENT_TOOL_SEARCH=true): optional — collapses the catalog behindfreeagent_search_tools/freeagent_call_toolfor a smallertools/list. Default is the full catalog (including on Vercel) - MCP elicitation:
create_invoicefalls back to a form elicitation whencontactis omitted (on clients that support it) - Two deployment modes: local (stdio) or cloud (Vercel serverless via Streamable HTTP)
- OAuth 2.0: stateless JWT-based auth for serverless, or direct token for local use
- Tool annotations:
readOnlyHint,destructiveHint,idempotentHint,openWorldHinton every tool - Zod validation: strict input schemas with
.describe()on all fields - Dual response formats: Markdown (human-readable) or JSON (structured)
- Pagination: proper header parsing with
x-total-countandLinkheaders - Rate limit handling: clear error messages with retry-after guidance
- Sandbox support: test safely against FreeAgent’s sandbox environment
Deployment Options
Local (stdio) - for Claude Desktop
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"freeagent": {
"command": "node",
"args": ["/path/to/freeagent-mcp-server/dist/index.js"],
"env": {
"FREEAGENT_ACCESS_TOKEN": "your_token",
"FREEAGENT_USE_SANDBOX": "true"
}
}
}
}