MCP server
Freshbooks MCP
FreshBooks invoicing for Claude — invoices, clients, estimates, and payments
Runs locallyStatus and history
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.3.1
- Listing updated
- 5 days ago
About Freshbooks MCP
Freshbooks MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add freshbooks-mcp --env FRESHBOOKS_CLIENT_SECRET='<FRESHBOOKS_CLIENT_SECRET>' --env FRESHBOOKS_REFRESH_TOKEN='<FRESHBOOKS_REFRESH_TOKEN>' -- npx -y @chrischall/freshbooks-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"freshbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
],
"env": {
"FRESHBOOKS_CLIENT_SECRET": "<FRESHBOOKS_CLIENT_SECRET>",
"FRESHBOOKS_REFRESH_TOKEN": "<FRESHBOOKS_REFRESH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"freshbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
],
"env": {
"FRESHBOOKS_CLIENT_SECRET": "<FRESHBOOKS_CLIENT_SECRET>",
"FRESHBOOKS_REFRESH_TOKEN": "<FRESHBOOKS_REFRESH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"freshbooks-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
],
"env": {
"FRESHBOOKS_CLIENT_SECRET": "<FRESHBOOKS_CLIENT_SECRET>",
"FRESHBOOKS_REFRESH_TOKEN": "<FRESHBOOKS_REFRESH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"freshbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
],
"env": {
"FRESHBOOKS_CLIENT_SECRET": "<FRESHBOOKS_CLIENT_SECRET>",
"FRESHBOOKS_REFRESH_TOKEN": "<FRESHBOOKS_REFRESH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"freshbooks-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/freshbooks-mcp"
],
"env": {
"FRESHBOOKS_CLIENT_SECRET": "<FRESHBOOKS_CLIENT_SECRET>",
"FRESHBOOKS_REFRESH_TOKEN": "<FRESHBOOKS_REFRESH_TOKEN>"
}
}
}
}Configuration
FRESHBOOKS_CLIENT_IDOAuth client ID from my.freshbooks.com/#/developerFRESHBOOKS_CLIENT_SECRETOAuth client secretFRESHBOOKS_REFRESH_TOKENOptional for local sign-in, which saves tokens privately. Required for hosted or legacy environment-token setup.FRESHBOOKS_REDIRECT_URIRegistered redirect URI; required on refresh calls too (default https://localhost)FRESHBOOKS_TOKEN_STOREPath for the rotating-refresh-token store (default ~/.freshbooks-mcp/session.json)FRESHBOOKS_BUSINESS_IDThe 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_ACCOUNT_IDOverrides 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 reports no account_id for the chosen business (accounting writes are refused until the pairing is confirmed this way).FRESHBOOKS_REQUEST_TIMEOUT_MSPer-request deadline for API calls, in milliseconds (default 30000)
Pricing
Open source
Freshbooks MCP FAQ
Is Freshbooks MCP free?
Yes. Freshbooks MCP is open source, so you can use and self-host it for free.
How do I add Freshbooks MCP to Claude Code?
Run this command in your terminal: claude mcp add freshbooks-mcp --env FRESHBOOKS_CLIENT_SECRET='<FRESHBOOKS_CLIENT_SECRET>' --env FRESHBOOKS_REFRESH_TOKEN='<FRESHBOOKS_REFRESH_TOKEN>' -- npx -y @chrischall/freshbooks-mcp