Freeagent Mcp Server

Local MCP server for FreeAgent accounting: bank reconciliation, expense and mileage claims, and receipts, driven by an assistant.

What you can do

• Reconcile bank transactions and work through FreeAgent accounting data
• Create and manage expense claims and mileage claims, with configurable pence-per-mile rates
• Handle receipts and attach them to claims
• Look up driving distances through Google Maps or OpenRouteService for mileage calculation
• Map vendor names to FreeAgent categories, extending the built-in mappings

When to use it

Useful for freelancers and small businesses that keep their books in FreeAgent and want an assistant to help with reconciliation, expense entry, mileage claims and receipt handling without switching between screens.

Requirements

Runs locally over stdio as an npm package, so Node.js is needed. Requires a FreeAgent OAuth app with FREEAGENT_CLIENT_ID, FREEAGENT_CLIENT_SECRET and a long-lived FREEAGENT_REFRESH_TOKEN. Distance calculation needs either GOOGLE_MAPS_API_KEY or ORS_API_KEY. Optional MILEAGE_RATE_PENCE and VENDOR_CATEGORIES settings.