samaxbytez/freeagent-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

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.

GitHub で README 全文を見る

インストール

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"
         }
       }
     }
   }