I
io.github.OxygenBubbles/freeagent-mcp-server
FreeAgent accounting MCP: bank reconciliation, expenses, mileage claims and receipts.
UnknownNot tested
16FNo CVEsunknown
Quick Install
{
"mcpServers": {
"io-github-oxygenbubbles-freeagent-mcp-server": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Embed in your READMEAbout badges →
[](https://mcppedia.org/s/io-github-oxygenbubbles-freeagent-mcp-server)
Should you use this server?
FreeAgent accounting MCP: bank reconciliation, expenses, mileage claims and receipts.
✓
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
License not specified.
~
Is it maintained?
Commit history unknown.
i
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
README
FreeAgent MCP Server
A Model Context Protocol server for FreeAgent accounting. Gives Claude (or any MCP client) the ability to list bank transactions, explain/approve them with receipts, create expenses, and log mileage.
What access this server requires
FreeAgent
The FreeAgent OAuth credentials grant full access to the connected FreeAgent account. This server uses that access to:
| Action | Tools that use it |
|---|---|
| Read bank accounts | freeagent_list_bank_accounts |
| Read bank transactions and explanations | freeagent_list_transactions |
| Update transaction explanations (category, description, approval, attachments) | freeagent_explain_transaction |
| Create expense claims | freeagent_create_expense, freeagent_create_mileage_expense |
| Read expense categories | freeagent_list_categories |
FreeAgent does not offer granular OAuth scopes — authorising an app grants access to all of the above. The server does not delete transactions, invoices, contacts, or any other data.
Email and file sources (external — not provided by this server)
This server has no email tools. For receipt/invoice search to work automatically, connect one or more of the following MCP servers alongside this one:
- Gmail (e.g.
mcp__claude_ai_Gmail) — personal email - Microsoft 365 / Outlook (e.g.
mcp__claude_ai_microsoft-365) — business email
When both are connected, Claude will search all of them automatically for matching receipts before asking you to provide a file manually.
Tools
| Tool | Description |
|---|---|
freeagent_list_bank_accounts | List all bank accounts and their IDs |
freeagent_list_transactions | List transactions (unexplained / explained / all / marked_for_review) with date filters |
freeagent_explain_transaction | Update, approve or attach a receipt to a transaction explanation |
freeagent_list_categories | List the FreeAgent chart of accounts (expense categories) |
freeagent_create_expense | Create an expense claim with optional receipt attachment and bank-transaction auto-matching |
freeagent_create_mileage_expense | Create a mileage expense using HMRC rates, with optional distance auto-calculation |
Prerequisites
FreeAgent OAuth credentials
- Log in to FreeAgent → Settings → Developer API.
- Create an OAuth application. Set the redirect URI to
http://localhost:8080/callback. - Note your Client ID and Client Secret.
- Run the bundled auth command to complete the OAuth flow and save a refresh token to
.mcp.jsonautomatically:
npx @oxygenbubbles/freeagent-mcp-server auth
The command prompts for your Client ID and Client Secret, opens the FreeAgent authorization page in your browser, listens for the callback, exchanges the code for a long-lived refresh token, and writes everything to .mcp.json in the current directory. If .mcp.json already exists, it updates just the freeagent entry.
Installation
git clone https://github.com/OxygenBubbles/freeagent-mcp-server.git
cd freeagent-mcp-server
npm install
npm run build
Configuration
All settings are read from environment variables.
Required
| Variable | Description |
|---|---|
FREEAGENT_CLIENT_ID | OAuth client ID |
FREEAGENT_CLIENT_SECRET | OAuth client secret |
FREEAGENT_REFRESH_TOKEN | Long-lived refresh token |
Optional
| Variable | Description |
|---|---|
VENDOR_CATEGORIES | JSON object extending the built-in vendor → category mapping (see below) |
MILEAGE_CATEGORY_URL | FreeAgent category URL for mileage expenses (default /v2/categories/311) |
MILEAGE_RATE_PENCE | Fixed pence-per-mile rate; overrides HMRC logic when set |
HMRC_RATE_HIGH_PENCE | HMRC high-band rate in pence (default 45) |
HMRC_RATE_LOW_PENCE | HMRC low-band rate in penc |
Test This Server
No automated test available for this server. Check the GitHub README for setup instructions.
Help improve this page
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationScore Breakdown
Security
3/30No known vulnerabilities.
○
Known CVEs — No package registry to scan
○
Tool safety — No tools to analyze
○
Tool poisoning — No tools to analyze
○
Injection vectors — No tools to analyze
✓
Tool stability — Tool definitions stable
○
Dependency health — No package to analyze
✗
License — No license specified
○
Authentication — No authentication required
○
Repository — active repo
CVEs checked daily via OSV.dev. Score algorithm is open source.
Reviews
Have you used this server?
Share your experience — it helps other developers decide.
How easy was setup?Did it work reliably?How was the documentation?
Sign in to write a review.
Frequently Asked Questions
- Is io.github.OxygenBubbles/freeagent-mcp-server safe to use?
- io.github.OxygenBubbles/freeagent-mcp-server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
- How do I install io.github.OxygenBubbles/freeagent-mcp-server?
- io.github.OxygenBubbles/freeagent-mcp-server can be installed by cloning its GitHub repository and following the setup instructions in the README.
- What AI clients work with io.github.OxygenBubbles/freeagent-mcp-server?
- io.github.OxygenBubbles/freeagent-mcp-server is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio transport.
Similar servers
View all →A
Alpha Vantage Mcp
No CVEs93A
Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
3 toolsremote1123661.9k/wk12d ago
Mcp_massive
No CVEs91A
An MCP server for Massive.com Financial Market Data
4 toolsremote29912906.2k/wk1d ago
I
io.github.imbenrabi/financial-modeling-prep-mcp-server
No CVEs88A
MCP server for Financial Modeling Prep API with 250+ financial data tools
5 toolsremote12828d ago
C
Clawpay MCP Server
No CVEs87A
Non-custodial x402 payments for AI agents. Sign locally, spend limits, Base network.
4 toolsremote423/wk6d ago
MCP Security Weekly
Get CVE alerts and security updates for io.github.OxygenBubbles/freeagent-mcp-server and similar servers.
Discussion
Start a conversation
Ask a question, share a tip, or report an issue.
Has anyone used this with Cursor?How do you handle auth?Any alternatives?
Sign in to join the discussion.