samaxbytez/freeagent-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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"
}
}
}
}