MCP App Store
by KeenEthics
Kairos Timer icon

Kairos Timer MCP Server for ChatGPT

By ParallelTPA LLC

Overview

Kairos is time tracking and invoicing for freelancers and small teams. With this plugin, ChatGPT runs your timer, reads your ledger and does your billing for you. Say "I'm starting on the Northwind redesign" and it starts the timer on the right project — it resolves loose names, confirms the client, project and task with you first, and stops whatever was running. "Stop the timer", "log 45 minutes on the report", "move the last entry to the redesign and make it an hour" all just work. Every hour the assistant logs is marked as an assistant's, so the ledger always shows its hours apart from yours. "Time report for last month by client", "how many agent hours went into the redesign", "how much of the Apex retainer is left this month", "who worked on Northwind this week" — each answer carries the split, and budgets say whether they cover the whole project or the month. A new engagement can start in the chat: "new client Acme, project Landing page at 150 an hour, start the timer" creates both — the rate read back for your yes — and starts the clock. Expenses too: "log the $40 Figma seat to Northwind". At month end: "what can I bill?" lists unbilled hours and expenses per client at your rates. "Invoice Northwind" shows the draft and creates it on your yes. Add a deposit, reword a line, take an entry off, mark it sent or paid; every change is confirmed and read back with the new total, and every version of a draft is kept. You choose what the assistant may do when you connect: the timer, invoicing, the workspace, or all three. Tokens are scoped to one workspace, expire and renew on their own, and can be revoked any time from Settings → Assistants and tools. Money is shown only to owners and managers, and nothing is sent to a client until you say so.

How to connect

  1. ChatGPT: Open the Kairos Timer listing in the ChatGPT app directory and choose Connect. ChatGPT listing Kairos Timer exposes 32 tools here.

Tools

client_create

ChatGPT
Make 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

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

ChatGPT
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_update

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

expenses

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

feedback

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

invoice_add_line

ChatGPT
Add 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

ChatGPT
Draft 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

ChatGPT
Reword 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

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

ChatGPT
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_set_status

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

invoices_list

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

invoices_unbilled

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

list_clients

ChatGPT
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_projects

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

members

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

project_alert_ack

ChatGPT
Mark 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

ChatGPT
Archive 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

ChatGPT
Where 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

ChatGPT
Make 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

ChatGPT
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_update

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

timer_entries

ChatGPT
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_entry_delete

ChatGPT
Delete 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

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

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

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

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

ChatGPT
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_stop

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

workspace_info

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

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/kairos-timer"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/kairos-timer)