financeoauth2

Freeagent

Cloud-based accounting software for freelancers and small businesses

Verdict

The Freeagent MCP connects your UK accounting data to Switchy, letting finance teams and freelancers query invoices, expenses, and tax estimates without opening the web app. @mention it to pull client balances, check VAT liability, or summarize outstanding invoices during planning calls. Most useful for accountants prepping client reviews and solo founders tracking cash flow. Requires OAuth with read access to your Freeagent account; write operations aren't exposed, so you'll still create invoices in Freeagent itself.

Common use cases

  • Check VAT liability before quarterly filing
  • List overdue invoices during collections review
  • Summarize monthly expenses for budget meetings
  • Pull client account balances for status calls
  • Estimate tax owed at end of quarter

Integration

Vendor
Freeagent
Category
finance
Auth
OAUTH2
Composio slug
freeagent

Tools

Per-tool listings haven't synced yet for Freeagent. The connection itself works - your Space can already @-mention it. Tool descriptions will fill in on the next Composio ingest.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to Integrations. 2. Find Freeagent in the MCP directory and click Connect. 3. You'll be redirected to Freeagent's OAuth consent screen—log in with your Freeagent credentials. 4. Grant read access to invoices, expenses, contacts, and bank transactions (Switchy requests these scopes by default). 5. After authorizing, you'll return to Switchy and see a green checkmark next to Freeagent. 6. Open any Space, type '@Freeagent show me unpaid invoices from this month' and send—if the MCP replies with a list, the connection works. 7. If you see an auth error, revisit Integrations and reconnect, ensuring you approve all requested scopes.

What teammates see: by default, memories from Freeagent are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

Unpaid Invoice Summary

@Freeagent show me all unpaid invoices, grouped by client, with totals and days overdue.
Open in a Space →

Monthly Expense Breakdown

@Freeagent list all expenses from last month, broken down by category, and calculate the total.
Open in a Space →

VAT Return Preview

@Freeagent calculate my VAT owed for this quarter, showing sales and purchases separately.
Open in a Space →

Client Balance Check

@Freeagent what's the current outstanding balance for [Client Name], including invoice dates?
Open in a Space →

Tax Estimate for Year

@Freeagent estimate my income tax liability for the current tax year based on profit so far.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@freeagent show me all unpaid invoices from the last 30 days with their amounts and due dates

Output

Based on your FreeAgent account, here are 4 unpaid invoices from the last 30 days: Invoice #1247 to Acme Corp for £3,200 (due May 15), Invoice #1251 to Beta Ltd for £1,850 (due May 22), Invoice #1253 to Gamma Inc for £4,100 (overdue since May 10), and Invoice #1256 to Delta Services for £2,400 (due June 2). Total outstanding: £11,550. The Gamma Inc invoice is 8 days overdue.

Notes

This read-heavy example demonstrates FreeAgent's core invoicing visibility. Requires OAuth2 scope for invoice read access. The MCP returns structured data the AI can parse and summarize — actual invoice counts and amounts will vary by your account state and date range.

Prompt

@freeagent create a new expense entry for £127.50 spent on office supplies today, categorized under General Expenses

Output

I've created expense entry #8842 in your FreeAgent account: £127.50 for office supplies, dated May 18, 2025, categorized as General Expenses. The entry is marked as unbilled and awaiting receipt attachment. You can view or edit it in FreeAgent under Expenses > All Expenses.

Notes

This write example shows expense creation, a common bookkeeping task. Requires OAuth2 write scope for expenses. Side-effect: the entry is immediately visible in FreeAgent and affects your accounts. You'll need to upload a receipt separately to complete the expense record per UK tax requirements.

Prompt

@freeagent pull my profit and loss summary for Q1 2025 and identify the three largest expense categories

Output

Your Q1 2025 profit and loss shows total income of £87,400 and expenses of £52,300, yielding a net profit of £35,100. The three largest expense categories were: Staff Costs (£28,100, 54% of expenses), Office & Property (£9,200, 18%), and Marketing & Advertising (£6,400, 12%). Staff costs increased 22% compared to Q4 2024, driven by a new hire in February.

Notes

This synthesis example pairs FreeAgent's financial reporting with AI analysis. The MCP fetches structured P&L data; the AI identifies patterns and calculates percentages. Useful for quarterly reviews without manual spreadsheet work. Accuracy depends on correct expense categorization in FreeAgent throughout the quarter.

Use-case deep-dives

Monthly close for service businesses

When Freeagent MCP speeds up month-end reconciliation

A 6-person design agency closes books on the 5th of each month. The finance lead pulls invoice data, checks payment status, and flags overdue accounts. With Freeagent MCP and OAuth2, the team can query outstanding invoices and payment timelines directly in Switchy without opening the Freeagent UI. This works when your invoice volume is under 200 per month and you're reconciling weekly or monthly. Above that threshold, you'll want dedicated accounting software integrations that handle bulk exports. The MCP shines for ad-hoc questions during standups or client calls—'did that retainer payment clear yet?'—where opening a separate tab breaks flow. If your team asks billing questions more than twice a week, this MCP pays for itself in context-switching time.

Client billing status lookup

Why customer-facing teams use Freeagent MCP for billing questions

A 3-person consulting shop fields client questions about invoice timing and payment terms. The account manager needs to answer 'when is my next invoice due?' without pinging the bookkeeper or switching apps. Freeagent MCP with OAuth2 lets the AM query invoice schedules and payment history in Switchy while drafting the client email. This scenario assumes you're on a retainer or recurring billing model with predictable invoice cadence. If you're doing one-off project billing with custom terms every time, the MCP won't have enough structured data to answer reliably. The buying threshold is simple: if your client-facing team asks billing questions more than once per client conversation, you need this lookup capability in the workspace where those conversations happen.

Expense tracking for remote teams

When Freeagent MCP handles distributed expense reporting

A 5-person remote SaaS team submits expenses weekly—software subscriptions, coworking passes, client meals. The ops lead reviews and categorizes them in Freeagent, but team members ask 'did my expense get approved?' or 'what's left in my quarterly budget?' multiple times per week. With Freeagent MCP, those questions get answered in Switchy without the ops lead becoming a bottleneck. This works when your expense volume is under 50 submissions per month and categories are stable. If you're processing hundreds of receipts or doing complex multi-entity accounting, you'll outgrow the MCP's query capabilities and need a full ERP integration. The decision point: if your team loses more than 30 minutes per week to expense-status questions, the MCP recovers that time immediately.

Frequently asked

What does the FreeAgent MCP do in Switchy?

It connects your FreeAgent accounting data to Switchy's AI workspace so your team can query invoices, expenses, and financial reports in natural language. Instead of logging into FreeAgent and clicking through menus, you ask questions like "show unpaid invoices from last month" and get answers inline. No tools are exposed yet, so the MCP currently surfaces read-only data for conversational access.

Do I need admin access to connect FreeAgent via OAuth?

Yes. FreeAgent's OAuth flow requires you to authorise Switchy with an account that has permission to view financial data. If you're not the practice owner or accountant with full access, the connection will fail or return incomplete data. Check your FreeAgent user role under Settings before attempting the OAuth handshake in Switchy.

Can the FreeAgent MCP create invoices or update expenses?

Not yet. The current integration exposes zero tools, which means it's read-only by default. You can query existing invoices, contacts, and bank transactions, but you can't write data back to FreeAgent from Switchy. If you need to create or edit records, open FreeAgent directly or use their API outside Switchy.

How is this different from using FreeAgent's web app or API?

The MCP removes the need to navigate FreeAgent's interface or write API calls yourself. Your team asks questions in plain English and Switchy handles the data retrieval. It's faster for ad-hoc queries but less powerful than the full web app for bulk edits or complex workflows. Think of it as a conversational shortcut, not a replacement.

Who on my team should connect the FreeAgent MCP?

Whoever owns your FreeAgent account or has accountant-level permissions. Once connected, any Switchy workspace member can query the data, but the OAuth token is tied to the connecting user's FreeAgent access. If that person leaves or loses permissions, the integration breaks. Plan accordingly and document who holds the connection.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.