Freshbooks MCP Server

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add freshbooks-mcp -- npx -y @chrischall/freshbooks-mcp

{
  "mcpServers": {
    "freshbooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/freshbooks-mcp"
      ]
    }
  }
}

[mcp_servers.freshbooks-mcp]
command = "npx"
args = ["-y", "@chrischall/freshbooks-mcp"]

{
  "mcpServers": {
    "freshbooks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/freshbooks-mcp"
      ]
    }
  }
}

{
  "servers": {
    "freshbooks-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/freshbooks-mcp"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: FRESHBOOKS_CLIENT_ID (OAuth client ID from my.freshbooks.com/#/developer), FRESHBOOKS_CLIENT_SECRET (OAuth client secret), FRESHBOOKS_REFRESH_TOKEN (Optional for local sign-in, which saves tokens privately. Required for hosted or legacy environment-token setup), FRESHBOOKS_REDIRECT_URI (Registered redirect URI; required on refresh calls too (default https://localhost)), FRESHBOOKS_TOKEN_STORE (Path for the rotating-refresh-token store (default ~/.freshbooks-mcp/session.json)), FRESHBOOKS_BUSINESS_ID (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_ACCOUNT_ID (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 reports no account_id for the chosen business (accounting writes are refused until the pairing is confirmed this way)), FRESHBOOKS_REQUEST_TIMEOUT_MS (Per-request deadline for API calls, in milliseconds (default 30000)).