List the user's clients (names to use with the other Peil tools).

Log worked hours for a client in Peil's timesheet.

Omit rate to use the client's default rate. date is ISO YYYY-MM-DD. Requires the timesheet:write key permission.

List billable hours not yet on any invoice, grouped per client.

Create a DRAFT invoice from a client's unbilled hours in a period.

Nothing is sent to the client — the user reviews the draft in Peil (or asks explicitly to send it via send_invoice). Grouping: 'summary' (one line per description), 'by_project', or 'per_day'. Requires invoices:write.

Send an invoice to the client BY EMAIL. Irreversible and client-facing.

invoice is a numeric id or invoice number. Only call this when the user has explicitly confirmed sending this specific invoice. Requires invoices:send.

Where does the user stand financially? Outstanding, overdue, drafts, YTD.

Edit an existing time entry. Only the fields you pass are changed.

Confirm with the user before editing an entry that's already on a sent/paid invoice (the server blocks it with INVOICE_LOCK). Requires timesheet:write.

Delete a time entry. Destructive — confirm with the user first.

Entries on a sent/paid/archived invoice are blocked server-side. Requires timesheet:write.

Show a client's details, including whether a default rate is configured.

Create a new client. Requires clients:write.

Set a default_rate so hours logged for this client aren't billed at €0.

Update a client's details. Only the fields you pass change. Requires clients:write.

Delete a client. Destructive — confirm first.

Blocked (409) if the client has projects or sent/paid invoices. Requires clients:write.

List invoices, most recent first. Optionally filter by status and/or client.

Change an invoice's status (e.g. mark paid). Requires invoices:write.

invoice is a numeric id or invoice number. This does NOT email anyone — it only records the status. Use send_invoice to actually email the client.

Update safe invoice fields (due date, payment date, notes). Requires invoices:write.

Line items and amounts are not edited here — redraft from hours for those.

Delete an invoice. Destructive — confirm first.

Paid invoices can't be deleted (archive instead); sent invoices are blocked unless the user is sure. Requires invoices:write.

Archive an invoice (hidden from default views, kept for records). Requires invoices:write.

Schedule a DRAFT invoice to be emailed at a future time. Client-facing.

scheduled_at is an ISO datetime (e.g. 2026-07-20T09:00:00). Only call this when the user has explicitly confirmed sending this invoice at this time. Requires invoices:send.

Cancel a previously scheduled send. Requires invoices:send.

Email a payment reminder for a sent/overdue invoice. Irreversible, client-facing.

Only call this when the user has explicitly confirmed reminding about this specific invoice. Requires invoices:send.

Show the user's custom reminder email copy and schedule.

Set the reminder email copy for one tone/language. Requires invoices:write.

Tones: pre_due (before due date), overdue (0–7 days late), formal (>7 days). Other tones/languages are preserved. Use {invoice_number}, {total_amount}, {due_date} placeholders as in Peil's editor.