mcp-freshbooks

Start FreshBooks OAuth2 authentication. Returns a URL to open in your browser. After authorizing, tokens are saved automatically.

Complete authentication with an authorization code (if callback server isn't used). Paste the code from the redirect URL.

Get the current authenticated user's identity, account ID, and business info.

List invoices with optional filters. Status: draft, sent, viewed, outstanding, paid.

Get full details of a specific invoice including line items.

Create a new invoice. Lines format: [{"name": "Service", "description": "...", "qty": 1, "unit_cost": {"amount": "100.00", "code": "USD"}}]

Update an invoice. Pass any writable invoice fields as updates dict.

Send an invoice by email to the client.

Delete an invoice permanently.

List clients. Optional search by name or organization.

Get full details of a specific client.

Create a new client.

Update a client. Pass any writable client fields.

List expenses with optional client filter.

Get full details of a specific expense.

Create a new expense. Amount as string (e.g. '150.00'). Date as YYYY-MM-DD.

List all payments.

Record a payment against an invoice. Amount as string. Date as YYYY-MM-DD. Types: Check, Credit, Cash, Bank Transfer, Credit Card, PayPal, ACH, Other.

List time entries.

Create a time entry. started_at as ISO8601 (e.g. '2026-03-20T09:00:00'). Duration in seconds.

List projects.

Create a project. project_type: hourly_rate or fixed_price. billing_method: business_rate, project_rate, service_rate, team_member_rate.

List estimates.

Create an estimate. Lines format same as invoices.

Get a financial report. Types: profitloss_entity, taxsummary, payments_collected. Dates as YYYY-MM-DD.