Kairos Timer

Rename 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.

project_update

Change 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_entry_update

Change 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.

expense_update

The 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_clients

Expenses (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.

expenses

Invoices newest first, with number, status, client, total and the id the other invoice tools take. Filter by status or client.

invoices_list

Every project time can be tracked against, as "Client / Project" labels with ids. Use when unsure which project the user means.

list_projects

Completed 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_entries

Record 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_log

Record 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_log

Move 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.

invoice_set_status

The 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_line_items

Take 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_remove_line

Pass 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.

feedback

Start 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_start

Stop 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.

timer_stop

Hours 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_report

Unbilled, 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.

invoices_unbilled

The 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_status

For 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_people

The 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.

members

The 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.

workspace_info