Skip to content

FreshBooks MCP connector

The FreshBooks connector lets Claude, ChatGPT, Cursor, and the Elaichi Agent look up clients, draft and send invoices, record expenses and payments, and post journal entries in FreshBooks, with every action tied to the person who signed in.

  • How it connects. Connects over OAuth. The credential goes into a vault nobody reads back.

  • One address. https://api.elaichi.ai/mcp, the same for every user.

  • Their own access. An agent never gets more than the person it acts for.

How to connect

How to connect FreshBooks to Claude, ChatGPT or Cursor

Two steps, about a minute.

1

In Elaichi

Connect FreshBooks once

  1. Open Connections, choose Add connection, and pick FreshBooks.

  2. Optionally set Share with to give a team access, then press Connect.

  3. Supply your own FreshBooks app, then approve. FreshBooks needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization.

The credential is vaulted. Nobody reads it back, not even the AI.

Add connection

Choose a connector.

freshbooks
FreshBooks
Acumatica
AngelList
Bexio
BlackLine
Buildium
2

In your AI client

Point it at one endpoint

Everyone in the organization uses the same address, and each person only ever reaches what their own account allows.

FreshBooks MCP connector for Claude

  1. 1

    Open Customize, then Connectors.

  2. 2

    Press Add.

  3. 3

    Name it, paste the MCP server URL, then Continue.

    https://api.elaichi.ai/mcp
  4. 4

    Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

FreshBooks MCP connector for ChatGPT

  1. 1

    Open Plugins, then press the + button.

  2. 2

    Name it and paste the endpoint into Server URL.

    https://api.elaichi.ai/mcp
  3. 3

    Leave Authentication on OAuth, then tick the risk acknowledgement.

  4. 4

    Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

FreshBooks MCP connector for Cursor

  1. 1

    Open ~/.cursor/mcp.json.

  2. 2

    Add the endpoint under mcpServers.

    https://api.elaichi.ai/mcp
  3. 3

    Reload Cursor, then sign in and approve.

~/.cursor/mcp.json

{
  "mcpServers": {
    "elaichi": {
      "url": "https://api.elaichi.ai/mcp"
    }
  }
}

Set up per machine, so repeat it on each computer you work from.

Connect FreshBooks to any MCP client

  1. 1

    Add the endpoint as a remote MCP server.

    https://api.elaichi.ai/mcp
  2. 2

    Sign in and approve.

{
  "mcpServers": {
    "elaichi": {
      "url": "https://api.elaichi.ai/mcp"
    }
  }
}

The Elaichi Agent already has these tools, with nothing to set up.

Use cases

What teams do with FreshBooks through Elaichi

Every one of these runs inside the access the person already has, and lands in the same audit log.

  • Finance

    Send the month's invoices without retyping them

    Ask for a new invoice for a client, check the line items, then have it sent from FreshBooks in one go. The invoice lands in the client's inbox the same way it would if you had clicked send yourself.

  • Bookkeeping

    Log expenses the moment receipts arrive

    Read out a receipt and have the expense created in FreshBooks with the right client, category and amount. Fix a wrong amount later by asking for the update rather than hunting through the list.

  • Finance

    Record payments and close out open invoices

    When a transfer shows up, ask which FreshBooks invoices are still outstanding for that client and record the payment against the right one. Overdue lists shrink without a spreadsheet in between.

  • Sales

    Check what a client owes before the call

    Pull up a client's FreshBooks record along with their open invoices and recent payments so the conversation starts with the facts. Add the new client to FreshBooks straight after the deal is agreed.

  • Accounting

    Post month-end journal entries from plain notes

    Describe the accrual or reclassification and have the journal entry created in FreshBooks, then list the entries for the period to confirm nothing is missing.

  • Customer success

    Issue a credit note when a refund is agreed

    When a client is owed money back, ask for a credit note in FreshBooks against the original invoice and confirm the amount. If it was raised in error, it can be removed just as quickly.

Try asking

  • “Show unbilled expenses for our top ten FreshBooks clients.”
  • “Draft a credit note for client Northwind's duplicate invoice.”
  • “Summarize journal entries logged in FreshBooks last month.”

See all 97 FreshBooks tools below

Compare

Elaichi vs Zapier MCP vs Composio for FreshBooks

All three can connect FreshBooks to an AI assistant, and all three have admin controls. They differ in where access lives and how you pay.

Elaichi compared with Zapier MCP and Composio for FreshBooks, by what to check
What to check Elaichi Zapier MCP Composio
Where the AI connects One address for the whole organization. https://api.elaichi.ai/mcp A server per member, created at sign-in. An MCP endpoint per team, or an SDK.
Control over FreshBooks tools Allow or restrict single FreshBooks tools, per role or user. App and action restrictions on the account. Role permissions, down to the action.
Record of calls One audit entry per FreshBooks call. A History tab of tool calls. A log of every tool call.
Single sign-on SAML or OIDC, plus SCIM, on Gold. SAML on Enterprise. SAML and OIDC on Enterprise.
Price $15 per user per month. 2 tasks per successful call. Billed per tool call.

Sources: Zapier MCP docs, security, usage; Composio docs, gateway, enterprise, pricing. Checked September 2026.

Longer take: Zapier MCP alternative and when you don't need an MCP gateway.

AI tools

FreshBooks tools for your AI agents

97 tools are ready to call through Elaichi's MCP endpoint the moment you connect FreshBooks, governed by the same roles, restrictions, and audit log as everything else in Elaichi.

See it in Elaichi

What connecting FreshBooks gets you

6 screens from the product, each doing one job for your FreshBooks account.

The agent

Ask about invoices, get real answers.

Question FreshBooks clients, expenses and credit notes in plain language and read live records.

  • clients
  • expenses
  • credit notes
  • journal entries

Ask Elaichi to work across your apps.

Show unbilled expenses for our top ten FreshBooks clients.

Draft a credit note for client Northwind's duplicate invoice.

Summarize journal entries logged in FreshBooks last month.

Also runs in Claude, ChatGPT or Cursor

MCP clients

One FreshBooks endpoint for every MCP client.

Claude, ChatGPT and Cursor connect over OAuth, with no SDK and no shared API key.

ElaichiMCP clients
Claude ChatGPT Cursor

Copy the endpoint

https://api.elaichi.ai/mcp
Client Connected by Status Last used
Claude
E

Emily Carter

• Connected 4 minutes ago
Cursor
M

Megan Brooks

• Connected 2 hours ago
ChatGPT
R

Ryan Hayes

• Connected Yesterday

Tool catalog

97 FreshBooks tools ready on connect.

Clients, expenses, credit notes and journal entries are covered without custom code.

  • Get single FreshBooks client by ID
  • List all FreshBooks clients
  • Create a FreshBooks client
  • Update a FreshBooks client by ID
ElaichiTools
Tool Action Description
Get single FreshBooks client by ID Get Get a single FreshBooks client by id. Returns the full client object including id, email, organization, fname, lname, currency_code, language, vis_state, uuid, and billing/shipping address fields. Required: account_id, id.
List all FreshBooks clients List List FreshBooks clients with optional search filters and includes. Returns: accounting_systemid, allow_email_include_pdf, allow_late_fees, allow_late_notifications, bus_phone, company_industry, company_size, currency_code, direct_link_token, email, exceeds_client_limit, fax, fname, has_retainer, home_phone, id, language, last_activity, last_login, level, lname, mob_phone, note, notified,…
Create a FreshBooks client Create Create a new FreshBooks client with contact details, billing/shipping address, currency, language, and optional secondary contacts. Returns the created client object including id, email, organization, fname, lname, currency_code, uuid, and vis_state. Required: account_id.
Update a FreshBooks client by ID Update Update a FreshBooks client by id with a partial client object. Returns the updated client including id, email, fname, lname, organization, currency_code, vis_state, uuid, and address fields. Required: account_id, id.
List all FreshBooks credit notes List List all FreshBooks credit notes for an account, including goodwill credits and prepayments. Returns each credit note with id, credit_number, credit_type, amount, clientid, status, create_date, payment_status, and billing address fields.

Toolboxes

Every team gets its own toolbox.

Curate FreshBooks toolboxes per team so Finance and Sales see different tools.

  • Finance
  • Accounts payable
  • Accounts receivable
  • Sales
ElaichiToolboxes
Name Source template Tools Created

Finance toolbox

FreshBooks · journal entries and credit notes

FreshBooks starter 18 Mar 4, 2026

Accounts payable toolbox

FreshBooks · expenses and vendor bills

— 9 Mar 2, 2026

Accounts receivable toolbox

FreshBooks · invoices and payments

— 24 Feb 27, 2026

Sales toolbox

FreshBooks · clients and estimates

FreshBooks starter 6 Feb 19, 2026

Client services toolbox

FreshBooks · time entries and projects

— 31 Jan 30, 2026

Leadership toolbox

FreshBooks · reports and revenue summaries

— 12 Jan 22, 2026

Shared connections

Share FreshBooks access, never the credential.

See who connected each account and how many teams and members work through it.

  • Finance
  • Accounts payable
  • Sales EMEA
  • Client services
ElaichiConnections
Connection Scope Status Access
FR

FreshBooks (Finance)

Connected by Emily Carter

Personal • Active 1 team · 6 members
FR

FreshBooks (Accounts payable)

Connected by Jake Morgan

Organization • Active 3 teams · 24 members
FR

FreshBooks (Sales EMEA)

Connected by Megan Brooks

Organization • Active 2 teams · 11 members
FR

FreshBooks (Client services)

Connected by Tyler Reed

Personal • Needs re-auth 1 team · 3 members
FR

FreshBooks (Payroll)

Connected by Ryan Hayes

Personal • Active Not shared
FR

FreshBooks (Leadership)

Connected by Ashley Parker

Personal • Active 2 teams · 9 members

Audit log

Answer who touched which invoice.

Every FreshBooks call is logged with time, person, action, type and resource.

  • When
  • Who
  • What happened
  • Type
ElaichiAudit log
When Who What happened Type

2 minutes ago

Mar 6, 2026, 3:10 PM

E

Emily Carter

emily.carter@northwind.io

Restriction Created Access

8 minutes ago

Mar 6, 2026, 3:04 PM

J

Jake Morgan

jake.morgan@northwind.io

Restriction Updated Access

14 minutes ago

Mar 6, 2026, 2:58 PM

M

Megan Brooks

megan.brooks@northwind.io

Role Assigned Access

20 minutes ago

Mar 6, 2026, 2:52 PM

T

Tyler Reed

tyler.reed@northwind.io

FreshBooks Users Updated MCP

26 minutes ago

Mar 6, 2026, 2:46 PM

R

Ryan Hayes

ryan.hayes@northwind.io

FreshBooks Clients Created MCP

32 minutes ago

Mar 6, 2026, 2:40 PM

A

Ashley Parker

ashley.parker@northwind.io

FreshBooks Clients List Toolbox

Launching soon

From answering questions to doing the work

A person no longer has to ask. A trigger starts the work, inside the same permissions and the same audit log as everything else. Automations and live dashboards are launching soon, on the Black plan.

Automations

A schedule fires, the expense digest ships.

Fetch FreshBooks expenses, group them, draft a digest, approve it, post it back.

FreshBooks digest

Run 418 · started 2 minutes ago · on behalf of Emily Carter

  1. ✓

    Schedule

    Every weekday at 8:00 AM

    0.2s
  2. ✓

    Fetch clients

    FreshBooks

    1.4s
  3. ✓

    Group by owner

    Transform

    0.1s
  4. ✓

    Draft the digest

    Agent step

    Ran with 4 tools, returned a structured summary

    6.2s
  5. Approve the digest

    Needs approval

    Assigned to Michael Brennan

    Approve
  6. Post the digest

    FreshBooks

    Queued

Collections and dashboards

FreshBooks numbers, counted not guessed.

Four metrics, 14 days of invoices created and a team breakdown, refreshed on schedule.

FreshBooks health

Refreshed 4 minutes ago · every 15 minutes · from the clients collection

Live

Clients

1,284 ↓ 12%

Expenses

96 ↓ 8%

Needs attention

3 ↑ 2

Updated this week

412 ↑ 9%

Clients created

Last 14 days

By team

Share of activity

Finance 34%

Accounts payable 27%

Sales EMEA 21%

Client services 18%

FAQ

Frequently asked questions

How do I connect FreshBooks to Claude?

First connect FreshBooks in Elaichi: FreshBooks asks you to register an app inside your FreshBooks account, so one person brings that client ID and secret once, and after that everyone signs in to FreshBooks through the normal FreshBooks login screen and approves access. Then in Claude go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Claude will ask you to sign in to Elaichi, and from there FreshBooks is available in your conversations.

Does FreshBooks work with ChatGPT and Cursor as well as Claude?

Yes. Once FreshBooks is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect FreshBooks once and every client you use picks it up.

What can an AI agent actually do with my FreshBooks data?

With FreshBooks connected, an agent can look up or add clients, create and send invoices, record expenses and payments, raise credit notes, post journal entries and check a tax rate, all from a plain request such as "send the March invoice for Harbor Design". FreshBooks is a large connector, so short, concrete asks that name the client or invoice work better than long paragraphs. It can also list what is outstanding and remove a payment, invoice or credit note that was entered by mistake.

Does connecting FreshBooks give the AI my whole set of books?

No. Every request runs inside the FreshBooks access of the person who signed in, so someone who cannot see payments or journal entries in FreshBooks cannot see them through an agent either. Elaichi can narrow that access further by team or by action, and it never widens what FreshBooks itself allows.

Can my team share one FreshBooks connection?

Yes. One person connects FreshBooks in Elaichi and shares the connection with a team, and nobody else ever handles the FreshBooks app credentials. Each person still signs in to Elaichi as themselves, so the audit log names who sent an invoice or recorded a payment in FreshBooks, not just which connection was used.

Can I stop an agent from deleting or changing things in FreshBooks?

Yes. In Elaichi you can allow reading FreshBooks clients and invoices while blocking the actions that delete invoices, payments or credit notes, or blocking anything that creates or edits records at all. A blocked action is never shown to Claude, ChatGPT or any other client, so no prompt, however worded, can reach it.

What happens to a FreshBooks connection when someone leaves?

When you offboard a person in Elaichi, their access to FreshBooks through every AI client ends at once. If they were sharing a FreshBooks connection with a team, that connection keeps working for everyone else. If you want FreshBooks gone entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client at the same time.

Does the FreshBooks MCP connector work with Gemini, Codex, Claude Code or other MCP clients?

Yes. FreshBooks is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs.

Is Elaichi an alternative to Zapier MCP for FreshBooks?

Yes. Both let Claude, ChatGPT or Cursor use FreshBooks. Zapier MCP fits a team that already automates in Zapier, since each person signs in and acts as themselves in that account. Elaichi fits when IT wants one address for the whole company, per-tool rules by role, and a record of every FreshBooks call.

How is Elaichi different from Composio for FreshBooks?

Composio gives AI agents tools and sign-in handling across 1,000+ apps, for developers building agents or people using an assistant, billed per tool call. Elaichi gives a company's own people governed access to FreshBooks: one address, restrictions per role or user, and $15 per user per month. Both have role permissions and a log of every call.

Put FreshBooks in front of your team

14 days on Gold, no credit card. Connect it once and pick what each team can call.

Works with
Claude ChatGPT Cursor and any other MCP client, or the Elaichi Agent.
When the trial ends
Nothing is deleted. Connections, roles and the audit log stay where they are, so subscribing picks up exactly where you left off.