MCP server for the FreeAgent
概览
An MCP server that gives Claude, Codex, Cursor, VS Code, Gemini CLI or any other MCP client the FreeAgent accounting API: 76 tools for invoices, expenses, bills, contacts, projects, timeslips, banking, estimates, credit notes and the accounting reports. Text that comes back from FreeAgent, such as a bank transaction's reference, can be written by someone outside your business, so the server assumes it may carry instructions aimed at the model. Tools that could hand over account access or send data out of the account are , every tool says whether it reads, writes or deletes, and receipts are only read from one folder you choose. The server runs locally, started by your MCP client, and talks to nothing but FreeAgent's API. That's also why ChatGPT and Grok can't use it yet: they only connect to MCP servers hosted on the internet (details). Node.js 24 or later, and a FreeAgent account. 1.
README
以下为原文 README 节选，完整内容请查看原文。
freeagent-mcp-server
An MCP server that gives Claude, Codex, Cursor, VS Code, Gemini CLI or any other MCP client the FreeAgent accounting API: 76 tools for invoices, expenses, bills, contacts, projects, timeslips, banking, estimates, credit notes and the accounting reports.
Text that comes back from FreeAgent, such as a bank transaction’s reference, can be written by someone outside your business, so the server assumes it may carry instructions aimed at the model. Tools that could hand over account access or send data out of the account are off by default, every tool says whether it reads, writes or deletes, and receipts are only read from one folder you choose.
Contents
How it fits together
Claude, Codex, Cursor, VS Code, … ──stdio──▶ freeagent-mcp-server (Node.js, on your machine)
├─ 76 tools; sensitive ones only with FREEAGENT_ENABLE_SENSITIVE_TOOLS
├─ OAuth2 tokens in ~/.freeagent-mcp/tokens.json, refreshed automatically
├─ receipts read from FREEAGENT_ATTACHMENTS_DIR only
└──HTTPS, your bearer token──▶ api.freeagent.com/v2 (or the sandbox)
The server runs locally, started by your MCP client, and talks to nothing but FreeAgent’s API. That’s also why ChatGPT and Grok can’t use it yet: they only connect to MCP servers hosted on the internet (details).
Quick start
Node.js 24 or later, and a FreeAgent account. New to this? Follow the step-by-step guide: docs/setup.md.
- Get a client ID and secret. In the
FreeAgent Developer Dashboard, create an app
with the redirect URI
http://localhost:3456/callback. Its OAuth identifier is your client ID and its OAuth secret is your client secret.
安装
npx -y freeagent-mcp-server配置
{
"mcpServers": {
"freeagent": {
"command": "npx",
"args": ["-y", "freeagent-mcp-server"],
"env": {
"FREEAGENT_CLIENT_ID": "your_client_id",
"FREEAGENT_CLIENT_SECRET": "your_client_secret"
}
}
}
}