Get the FreshBooks consent URL to authorise this connection. Open it, approve, and you'll land on the redirect URL — pass that whole URL (or just its ?code= value) to freshbooks_auth_exchange. Read-only; contacts nothing.

Exchange a FreshBooks authorization code for a refresh token. Accepts the whole redirect URL you landed on, or the bare code. The authorization code is SINGLE-USE — if this fails, get a new one from freshbooks_auth_url rather than retrying.

Resolve the authenticated FreshBooks user and their identifiers: accountId (alphanumeric, used by accounting and payments endpoints), businessId (integer, used by projects and time tracking) and businessUuid. The three are not interchangeable — using the wrong one returns a 404 rather than a useful error.

Resolves the credential the way real tools do, then makes one authenticated request to api.freshbooks.com. Reports which source supplied the credential, whether api.freshbooks.com accepted it, the round-trip time, and a plain-English hint distinguishing 'no credential' from 'credential rejected' from 'a api.freshbooks.com-side problem'. Call this when a real tool fails and you want to know which hop broke. Read-only; never returns the credential itself.

List invoices for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single invoice by its numeric FreshBooks id.

List clients for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single client by its numeric FreshBooks id.

List estimates for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single estimate by its numeric FreshBooks id.

List payments for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single payment by its numeric FreshBooks id.

List items for the authenticated FreshBooks account. Supports pagination and raw FreshBooks filter params. Returns items plus page/pages/total.

Get a single item by its numeric FreshBooks id.

Create a client (customer) in FreshBooks. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

Create an invoice for a client. Created invoices start as drafts. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

Update an existing invoice. Only the supplied fields are sent. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call. Note that changing an invoice out of draft can email it to the client.

Record a payment against an invoice. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

Accept an estimate on behalf of the account, by sending FreshBooks' action_accept on the estimate (PUT estimates/estimates/{id} with {"estimate": {"action_accept": true}}). Acceptance is not reversible through the API — there is no un-accept action — so this requires confirm: true to execute; without it returns a dry-run preview and makes no network call. Idempotent: an estimate already accepted or invoiced is returned unchanged with changed: false and no write is sent. Returns the re-fetched estimate.

NOT SUPPORTED by the FreshBooks API — this tool always fails, and never sends a request. FreshBooks models no declined state for estimates: the status set is draft / sent / viewed / replied / accepted / invoiced, there is no action_deny or action_decline counterpart to action_accept in FreshBooks' own API collection, and there is no estimate.decline webhook event. The tool exists so this answers with the reason instead of a plausible-looking write that changes nothing. Call it to get the alternatives.

Update an existing estimate. Only the supplied fields are sent; anything omitted is left alone. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call. Supplying lines REPLACES the whole line set — include each existing line's lineid to keep it. Returns the re-fetched estimate.

Email an estimate to the client, by sending FreshBooks' action_email on the estimate (PUT estimates/estimates/{id} with {"estimate": {"action_email": true, …}}). This puts mail in a client's inbox, so it requires confirm: true to execute; without it returns a dry-run preview and makes no network call. Omitting email_recipients lets FreshBooks use the client's own address. Returns the re-fetched estimate.

List expenses for the account, newest-first by default. Supports pagination and raw FreshBooks filters (e.g. {"search[categoryid]": 5}). If the response reports a total with no rows, the count includes records this identity cannot read — that is reported in the note field rather than looking like an empty account.

Get a single expense by its numeric id.

List expense categories, which supply the categoryid used when creating an expense.

Record an expense. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

List projects for the business. Uses businessId (not accountId) and works even when the business has no accounting account.

Get a single project by its numeric id.

Create a project. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

List tracked time entries for the business. The response envelope also carries total_logged and total_unbilled alongside the rows.

Log a time entry. Duration is in SECONDS. Requires confirm: true to execute; without it returns a dry-run preview and makes no network call.

List services (the billable work types available to projects and time entries).

List any FreshBooks accounting resource by name — the generic reader covering the long tail (taxes, credit notes, invoice profiles, tasks, staff, gateways, bills, bill vendors, bill payments, other income, expense categories) alongside the ones with dedicated tools. Returns items plus page/pages/total. Some resources are gated by plan or account role and will report that rather than returning rows.

Get a single record from any FreshBooks accounting resource by name and id. Ids are numeric on every resource mapped here; the schema also accepts a string so an id carried around as text still works.