freshbooks-mcp
CommunityMCP server by chrischall · updated · ★ 0 · 208 downloads a week
FreshBooks invoicing for Claude — invoices, clients, estimates, and payments freshbooks-mcp is a community project by chrischall, not verified by a company domain.
Install freshbooks-mcp
Built from the published package, never by AIclaude mcp add freshbooks-mcp -- npx -y @chrischall/freshbooks-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"freshbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"freshbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"freshbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add freshbooks-mcp -- npx -y @chrischall/freshbooks-mcp{
"mcpServers": {
"freshbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add freshbooks-mcp npx -y @chrischall/freshbooks-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the freshbooks-mcp block.
Last commit 5 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
FRESHBOOKS_Environment variable | Optional | OAuth client ID from my.freshbooks.com/#/developer |
FRESHBOOKS_Environment variable, secret | Optional | OAuth client secret |
FRESHBOOKS_Environment variable, secret | Optional | Optional for local sign-in, which saves tokens privately. Required for hosted or legacy environment-token setup. |
FRESHBOOKS_Environment variable | Optional | Registered redirect URI; required on refresh calls too (default https://localhost) |
FRESHBOOKS_Environment variable | Optional | Path for the rotating-refresh-token store (default ~/.freshbooks-mcp/session.json) |
FRESHBOOKS_Environment variable | Optional | The integer businessId to work in when the authenticated identity belongs to several businesses. Without it, reads use the first business FreshBooks lists and writes are refused rather than landing in the wrong books. |
FRESHBOOKS_Environment variable | Optional | Overrides the account id normally resolved from /auth/api/v1/users/me. Set it explicitly when the authenticated identity belongs to no business membership and resolution fails, or, together with FRESHBOOKS_BUSINESS_ID, when FreshBooks repor |
FRESHBOOKS_Environment variable | Optional | Per-request deadline for API calls, in milliseconds (default 30000) |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Weekly newsletter
Like freshbooks-mcp? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md, package.json. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to freshbooks-mcp
All alternatives →MCP server integrating with Stripe - tools for customers, products, payments, and more.
Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets
200+ transparent financial metrics calculated from raw statements, not third-party endpoints.
JS API for Yahoo Finance
x402 Payment Protocol
x402 Payment Protocol
freshbooks-mcp: common questions
How do I install freshbooks-mcp?
In Claude Code run claude mcp add freshbooks-mcp -- npx -y @chrischall/freshbooks-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is freshbooks-mcp the official server?
freshbooks-mcp is a community project by chrischall, not verified by a company domain.
Is freshbooks-mcp free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is freshbooks-mcp safe to use?
It scores 80 of 100. Grades: maintenance A, licence A, quality C. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to freshbooks-mcp?
Similar MCP servers: mcp, CCXT, Finance Toolkit, Yahoo Finance2.
Does freshbooks-mcp work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
