samaxbytez/freeagent-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

6 stars 6 forks Качество 85 Тренд 34MIT

Repository Install

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

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.

How it fits together
Quick start
What it can do
Settings
Development
Documentation
Links

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.

Открыть полный README на GitHub

Установка

npx -y freeagent-mcp-server

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
     "mcpServers": {
       "freeagent": {
         "command": "npx",
         "args": ["-y", "freeagent-mcp-server"],
         "env": {
           "FREEAGENT_CLIENT_ID": "your_client_id",
           "FREEAGENT_CLIENT_SECRET": "your_client_secret"
         }
       }
     }
   }