MCP.Market

Freshbooks MCP server

by chrischall·io.github.chrischall/freshbooks-mcp·v1.2.2
No reviews yet

FreshBooks invoicing for Claude — invoices, clients, estimates, and payments

B83/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B83/100

not scanned yet

Adoption
Growing

0 stars839 downloads/wk

Reviews

Write one

Nobody has reviewed Freshbooks yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Freshbooks tools

No tool declarations could be read from the package source. They show once the server is installed.

Not scanned yet. New listings are scanned within a day or two of arriving.

How Freshbooks compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
83/100
higher than 65% of 48,255 servers
Downloads a week
839
more than 93% of 12,191 servers with a package

Release history: 12 versions in the registry since 2026-09-10, latest 2026-10-16, typically one every 2 days.

Install Freshbooks in Claude Code, Cursor or VS Code

Runs npx -y @chrischall/freshbooks-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add freshbooks-mcp -- npx -y @chrischall/freshbooks-mcp
Add to Cursor

What the publisher says

From the Freshbooks repository's README, as published. We do not edit it. Read it on GitHub

freshbooks-mcp

MCP server for FreshBooks — invoices, clients, estimates and payments, exposed to Claude as typed tools.

This project was developed and is maintained by AI (Claude Code). Use at your own discretion.

Install

npm install -g @chrischall/freshbooks-mcp

Setup

FreshBooks is OAuth2 only — there is no API key and no personal access token, so a one-time browser authorization is required.

HTTPS with no query string; https://localhost works and never needs to resolve.

  1. Register an app at . The redirect URI must be
  1. Note the Client ID and Client Secret.
  2. Obtain a refresh token, either way:

FRESHBOOKSCLIENTSECRET, start it, then call freshbooksauthurl, open the URL it returns, approve, and pass the URL you land on to freshbooksauthexchange. Those two tools need no refresh token — minting one is what they are for. This is also the path mcp-host's authFlow drives, so a hosted connector can do it without you pasting anything.

  • From the server itself (no script): set FRESHBOOKSCLIENTID and

skills/freshbooks-curl.

  • From the script, if you prefer it outside the server — see
  1. Configure:
FRESHBOOKS_CLIENT_ID=...
FRESHBOOKS_CLIENT_SECRET=...
FRESHBOOKS_REFRESH_TOKEN=...       # from the bootstrap
FRESHBOOKS_REDIRECT_URI=https://localhost   # optional; must match what you registered
FRESHBOOKS_TOKEN_STORE=~/.freshbooks-mcp/session.json   # optional

⚠️ Refresh tokens rotate

FreshBooks issues a new refresh token on every refresh and immediately invalidates the old one. This server persists each rotation to FRESHBOOKSTOKENSTORE (mode 0600) before the refresh is considered complete, and prefers the stored token over the environment value — the stored one has rotated past it.

Two consequences worth knowing:

skill keep separate state files on purpose; sharing one makes them spend each other's tokens and locks both out.

  • Do not point two tools at the same store. The MCP server and the freshbooks-curl

recovered.

  • If the store is lost, re-run the bootstrap. A spent refresh token cannot be

Changing FRESHBOOKSREFRESHTOKEN to a freshly bootstrapped value is detected and adopted, so re-bootstrapping is the supported recovery path.

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Grade history

  • 2026-09-19downgradeA → Bscore 83

Freshbooks: common questions

Is Freshbooks MCP server safe?
Mostly: it is graded B (83/100). Read the Freshbooks safety report
How do I install Freshbooks?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Freshbooks need an API key?
Yes. The registry entry asks for FRESHBOOKS_CLIENT_SECRET, FRESHBOOKS_REFRESH_TOKEN.
Is Freshbooks maintained?
The last commit was 35 days ago (2026-09-30). The latest release is v1.2.2.
How does Freshbooks compare with other MCP servers?
safety score 83/100 (higher than 65% of 48,255 servers); downloads a week 839 (more than 93% of 12,191 servers with a package). Full comparison.

More from chrischall →