npm · @chrischall/freshbooks-mcp
$npx -y @chrischall/freshbooks-mcp@1.2.1 FRESHBOOKS_CLIENT_ID — OAuth client ID from my.freshbooks.com/#/developer
FRESHBOOKS_CLIENT_SECRET · secret — OAuth client secret
FRESHBOOKS_REFRESH_TOKEN · secret — 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)