io.github.OxygenBubbles/freeagent-mcp-server

MCP

by OxygenBubbles · v2.1.0

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

mcplocal

MCP configuration

stdio

Command

npx -y @oxygenbubbles/freeagent-mcp-server@2.1.0

Environment

  • FREEAGENT_CLIENT_IDrequiredsecret

    FreeAgent OAuth app client ID (from dev.freeagent.com)

  • FREEAGENT_CLIENT_SECRETrequiredsecret

    FreeAgent OAuth app client secret

  • FREEAGENT_REFRESH_TOKENrequiredsecret

    FreeAgent long-lived OAuth refresh token

  • VENDOR_CATEGORIES

    JSON map of vendor name to FreeAgent category URL (extends built-in mappings)

  • MILEAGE_RATE_PENCE

    Default pence-per-mile rate (overrides HMRC 45p/25p)

  • ORS_API_KEYsecret

    OpenRouteService API key for driving distance calculation

  • GOOGLE_MAPS_API_KEYsecret

    Google Maps API key (alternative to ORS for distance calculation)

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.