client_create
ChatGPTMake a new client (the party that gets invoiced). Call with dryRun=true first and confirm the name, then again without dryRun. A name already in use is refused — use client_update. Then project_create adds a project to track time against.
client_update
ChatGPTRename a client or change its email or address. Fields left out are untouched; null clears one. Call with dryRun=true first and confirm, then again without dryRun passing client = the id from the dry run.
expense_log
ChatGPTRecord a cost to bill a client for — a software seat, a train ticket, the AWS bill — by amount in the workspace's currency, against a client or a project. Call with dryRun=true first, confirm the amount and client, then again without dryRun passing client = the id from the dry run. The expense is unbilled at once and lands on the client's next invoice draft.
expense_update
ChatGPTChange an unbilled expense (an id from expenses): its client, project, description, amount, date, category or notes. Fields left out are untouched. Call with dryRun=true first and confirm. One already on an invoice is refused (incidental_invoiced) with the way out.
expenses
ChatGPTExpenses (costs paid on a client's behalf and billed through), newest first, for a client or project over a window, with ids and the categories this workspace uses. Use for "what did we spend on Northwind", "what expense categories are there", "which expenses are unbilled". Owners and admins only.
feedback
ChatGPTPass a note to the people who make Kairos: a wish, a bug, something that was confusing. Use when the user says "tell Kairos…" or asks for something the connector can't do. Sends the message and the workspace id, nothing else about the user.
invoice_add_line
ChatGPTAdd one line to a draft invoice: a custom line (description with amountCents, or quantity × unitPriceCents; a negative amount is a discount), or one of the client's unbilled entries (timeEntryId) or expenses (incidentalId). Only drafts can be edited; every edit keeps the previous version and gives the lines new ids. Confirm the amount with the user first.
invoice_draft
ChatGPTDraft an invoice for a client from everything unbilled (optionally within a window). Call with dryRun=true first: it resolves the client by id or name and returns the lines, total and period without creating anything. Confirm, then call again without dryRun passing client = the id from the dry run. If the client is a Stripe customer a matching draft is created in the user's Stripe account; nothing is sent.
invoice_edit_line
ChatGPTReword a line on a draft (description; null on a time or expense line restores the generated text), or reprice a custom line (amountCents, or quantity and unitPriceCents). Time and expense lines are priced from their records and cannot be repriced here. Confirm with the user first.
invoice_line_items
ChatGPTThe lines of an invoice (any status), numbered in the summary so "the second line" is lineItems[1]. Each line has an id, kind (time, incidental or custom), description and amount.
invoice_remove_line
ChatGPTTake a line off a draft. A time or expense line's source goes back to unbilled; a custom line just goes. Refused for the last remaining line (void the invoice instead). Confirm with the user first.
invoice_set_status
ChatGPTMove an invoice through its lifecycle: draft → sent, paid, void; sent → paid, void. Paid and void are final. "sent" on a Stripe-mirrored invoice finalizes it and emails the client through Stripe — tell the user before doing it. "void" puts the entries back in the unbilled pool. Always confirm first.
invoices_list
ChatGPTInvoices newest first, with number, status, client, total and the id the other invoice tools take. Filter by status or client.
invoices_unbilled
ChatGPTUnbilled, completed time and expenses per client, priced at each project's hourly rate, with the period they span. Flags projects with no rate, whose hours cannot be invoiced until one is set on the web.
list_clients
ChatGPTThe workspace's clients with ids and how many projects each has. Use to resolve who the user means before drafting an invoice or starting a timer.
list_projects
ChatGPTEvery project time can be tracked against, as "Client / Project" labels with ids. Use when unsure which project the user means.
members
ChatGPTThe workspace's members with their roles and hours over a window (default this week), plus the assistant's hours as a row of its own where it has any. Use for "who is on the team", "who did the most hours this week". Owners and admins only.
project_alert_ack
ChatGPTMark a budget alert (an id from project_budget's openAlerts) as seen by the user, so the web stops showing it to them. Idempotent; no confirmation needed.
project_archive
ChatGPTArchive a project: it leaves the project lists, its entries and invoices stay. Destructive — call with dryRun=true, say what stays on the record, and archive only on a clear yes. Refused while a timer is running on it.
project_budget
ChatGPTWhere a project stands against its hour budget or monthly retainer: hours used, hours left, percent, days left in the period, where the current pace lands, whether hours over the allowance would bill, open alerts, and how much of the time was an assistant's. A budget covers either the whole project (never resets) or one calendar month (resets on a set day); there are no weekly budgets. Always tell the user which (period.kind in the result), as the summary does. Give a project, or a client for all its projects, or nothing for every budgeted project. A project with neither says so. Fees and rates for owners and admins only. Read-only.
project_create
ChatGPTMake a project under a client, with its hourly rate. The rate is what every hour on it will be invoiced at, so call with dryRun=true, say the rate back out loud ("Create Acme / Landing page at $150 an hour?") and create only on a yes, passing client = the id from the dry run. Then timer_start can start on it.
project_people
ChatGPTFor one project over a window (default this week): each person's actual hours against the hours planned for them, and the assistant's hours as its own row. Use for "who worked on Northwind this week and how much was the assistant". A member sees their own entries; an owner or admin sees everyone's. Read-only.
project_update
ChatGPTRename a project, set or change its hourly rate, its default billable flag, its hour budget or its colour. A changed rate prices every unbilled hour on the project, so say the old and new rate back and confirm before saving. Call with dryRun=true first, then again without dryRun passing project = the id from the dry run.
timer_entries
ChatGPTCompleted time entries, newest first, for a project or client over a window, with the hours split between an assistant's entries (made through this connector or a token) and people's. Use for "what went into the redesign", "how many agent hours did Northwind get this month", "what did the assistant log this week". Without a project or client it covers this week. The user's own entries; an owner or manager sees the workspace's.
timer_entry_delete
ChatGPTDelete a completed entry (an id from timer_entries, or "last"). Destructive: call with dryRun=true, read the entry back to the user, and delete only on a clear yes. The running timer cannot be deleted — stop it first. An entry on an invoice is refused (entry_invoiced).
timer_entry_update
ChatGPTChange a completed entry: move it to another project, change its duration (minutes, keeping its end) or its start and end, reword or clear its note, or flip billable. entry is an id from timer_entries or "last" for the user's most recent entry. Call with dryRun=true first and confirm, then again without dryRun passing entry = the id from the dry run. The running timer is not an entry here — timer_stop ends it. An entry on an invoice is refused (entry_invoiced) with the way out. Own entries only, unless the user is an owner or admin.
timer_log
ChatGPTRecord time that already happened: either minutes (ending now) or an explicit start and end (ISO 8601 with offset). Call with dryRun=true first and confirm, then again without dryRun passing project = the id from the dry run. When the time overlaps the user's existing entries or running timer the dry run lists them (overlaps) — say so, since that time would count twice, and log only if the user still wants it.
timer_report
ChatGPTHours over a window grouped by client, project or person, each with billable and non-billable hours and how much of the time was an assistant's. Use for "time report for last month by client", "who did the hours on Northwind", "how much did the assistant do this week". groupBy=person lists each member plus one row "Assistant". Money (value at the project rates) appears for owners and admins only; a member sees their own hours. Read-only.
timer_start
ChatGPTStart a timer on a project, stopping whatever was running. Call with dryRun=true first: it resolves the project (by id, name or "Client / Project"), says what would stop, and changes nothing. Confirm with the user, then call again without dryRun passing project = the id from the dry run. Omit project to reuse the last project worked on.
timer_status
ChatGPTThe running timer, if any: its client / project, task and elapsed time. Use for "what am I working on", "is a timer running", "how long have I been on this".
timer_stop
ChatGPTStop the running timer. Optionally set or append a note about what was done. Errors with no_running_timer when nothing is running. No confirmation needed.
workspace_info
ChatGPTThe workspace's name, currency, invoice terms (payment days, tax, time rounding), plan and trial, member count and cap, connected apps (Stripe, QuickBooks, Xero, Google Calendar), and who the user is here: role and the scopes this token has. Use to answer "what currency is this workspace in" or to explain why a tool is missing or refused. Kairos has no workspace timezone; pass tz on calls that take it. Read-only.