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 supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.OxygenBubbles/freeagent-mcp-server do?

io.github.OxygenBubbles/freeagent-mcp-server provides 6 tools: freeagent_list_bank_accounts, freeagent_list_transactions, freeagent_explain_transaction, freeagent_list_categories, freeagent_create_expense and 1 more. See the full tools list on the server page for descriptions and parameters.

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. It uses stdio transport.

Is io.github.OxygenBubbles/freeagent-mcp-server actively maintained?

io.github.OxygenBubbles/freeagent-mcp-server is actively maintained — last commit was 27 days ago.

io.github.OxygenBubbles/freeagent-mcp-server

@oxygenbubbles/freeagent-mcp-server

FreeAgent accounting MCP: bank reconciliation, expenses, mileage claims and receipts.

45/wk 6 tools GitHub npm

No known CVEs

No license

Actively maintained

Last commit 27d ago

Works with most clients

Transport: stdio

6 tools · ~325 tok

Grade A · 0.2% of 200K ctx

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "freeagent": {
      "env": {
        "FREEAGENT_CLIENT_ID": "...",
        "FREEAGENT_CLIENT_SECRET": "...",
        "FREEAGENT_REFRESH_TOKEN": "..."
      },
      "args": [
        "/path/to/freeagent-mcp-server/dist/index.js"
      ],
      "command": "node"
    }
  }
}

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 →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-oxygenbubbles-freeagent-mcp-server)](https://mcppedia.org/s/io-github-oxygenbubbles-freeagent-mcp-server)

Read me

What io.github.OxygenBubbles/freeagent-mcp-server does

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.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y '@oxygenbubbles/freeagent-mcp-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

85/100across 5 weighted dimensions

How we score →

0255075100

−15

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @oxygenbubbles/freeagent-mcp-server against OSV.dev.

Inventory

Tools (6)

Click any tool to inspect its schema.

~325 tokens total

Community

Reviews

Be the first to review

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?

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 supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.OxygenBubbles/freeagent-mcp-server do?: io.github.OxygenBubbles/freeagent-mcp-server provides 6 tools: freeagent_list_bank_accounts, freeagent_list_transactions, freeagent_explain_transaction, freeagent_list_categories, freeagent_create_expense and 1 more. See the full tools list on the server page for descriptions and parameters.
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. It uses stdio transport.
Is io.github.OxygenBubbles/freeagent-mcp-server actively maintained?: io.github.OxygenBubbles/freeagent-mcp-server is actively maintained — last commit was 27 days ago.

Similar servers

Others in finance

View all →

io.github.shigechika/jquants-mcp92

MCP server for retrieving Japanese stock market data via J-Quants API v2

1 5

Alpha Vantage Mcp91

Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators

178 3

io.github.PromptPartner/bexio-mcp-server90

Swiss accounting integration for Bexio. 310 tools for invoices, contacts, projects.

20 6

io.github.Licinexus/mcp90

Brazilian public procurement (PNCP) and Federal Revenue CNPJ data — 16 tools, 4 prompts.

68 3

MCP Security Weekly

Get CVE alerts and security updates for io.github.OxygenBubbles/freeagent-mcp-server and similar servers.

Community

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?

Edit this pageView history

Finance

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "freeagent": {
      "env": {
        "FREEAGENT_CLIENT_ID": "...",
        "FREEAGENT_CLIENT_SECRET": "...",
        "FREEAGENT_REFRESH_TOKEN": "..."
      },
      "args": [
        "/path/to/freeagent-mcp-server/dist/index.js"
      ],
      "command": "node"
    }
  }
}

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 →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-oxygenbubbles-freeagent-mcp-server)](https://mcppedia.org/s/io-github-oxygenbubbles-freeagent-mcp-server)

Read me

What io.github.OxygenBubbles/freeagent-mcp-server does

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.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y '@oxygenbubbles/freeagent-mcp-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

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.json automatically:

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

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

85/100across 5 weighted dimensions

How we score →

0255075100

−15

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @oxygenbubbles/freeagent-mcp-server against OSV.dev.

Inventory

Tools (6)

Click any tool to inspect its schema.

~325 tokens total

Community

Reviews

Be the first to review

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?

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 supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.OxygenBubbles/freeagent-mcp-server do?: io.github.OxygenBubbles/freeagent-mcp-server provides 6 tools: freeagent_list_bank_accounts, freeagent_list_transactions, freeagent_explain_transaction, freeagent_list_categories, freeagent_create_expense and 1 more. See the full tools list on the server page for descriptions and parameters.
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. It uses stdio transport.
Is io.github.OxygenBubbles/freeagent-mcp-server actively maintained?: io.github.OxygenBubbles/freeagent-mcp-server is actively maintained — last commit was 27 days ago.