Skip to content
MCP server

Freshbooks MCP

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

Runs locallyStatus and history
Install
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-mcp

Add 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/#/developer
  • FRESHBOOKS_CLIENT_SECRETOAuth client secret
  • FRESHBOOKS_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