The second pair of hands

MCP time tracking for your agents

Connect Claude, Cursor or any MCP client to Kairos and your agents keep their own time, against your clients and marked as theirs, and read the ledger: what’s unbilled, what’s been paid. Agents don’t count as seats.

Start free for 14 days Read the setup guide

Setup

Three steps, about a minute

The connector’s address:

https://time-api-f6m3.onrender.com/mcp

I
Add the connector
Paste the connector’s address into your client — the exact steps for Claude Code, Cursor, Claude, ChatGPT, Codex and VS Code are below. It speaks Streamable HTTP with OAuth, so any MCP client that takes a URL works.
II
Sign in and choose
Kairos opens and asks what the agent may do: run the timer, help with invoices, set up clients and projects, or all three. No token to paste. A client that only takes a header can use a personal access token from Settings → Assistants and tools instead.
III
Say what you’re starting
“Start on Northwind, PR review.” The agent confirms the client and project, then rings the bell. Say “stop” when the work is done, or “log 45 minutes on the report” after the fact.

Your client

The same address, wherever you work

One remote server; each client adds it its own way. Sign in once per client and Kairos remembers the grant under Settings → Assistants and tools.

Claude Code

Run the command, then /mcp in a session to sign in.

claude mcp add --transport http kairos https://time-api-f6m3.onrender.com/mcp

Cursor

Settings → Tools & MCP → Add custom MCP server, or add this to ~/.cursor/mcp.json. Cursor opens the sign-in when it first connects.

{ "mcpServers": { "kairos": { "url": "https://time-api-f6m3.onrender.com/mcp" } } }

Claude Desktop and Claude.ai

Settings → Connectors → Add custom connector. Paste the address, then approve Kairos when it opens. The connector is on in every new chat.

https://time-api-f6m3.onrender.com/mcp

ChatGPT

Install the Kairos Timer plugin from ChatGPT’s directory, from the browser you use for Kairos. It opens the consent page; allow it, then mention the plugin in a chat. Or add the address by hand: Settings → Plugins → Add → Add MCP server.

https://chatgpt.com/plugins/plugin_asdk_app_6ae3848fcbc88191bcec05f6cd5dcf53

Codex CLI

Add the server, then sign in once. Codex keeps the grant for later sessions.

codex mcp add kairos --url https://time-api-f6m3.onrender.com/mcp
codex mcp login kairos

VS Code

Command Palette → MCP: Add Server → HTTP, paste the address; or put this in .vscode/mcp.json. The tools appear in Copilot’s agent mode.

{ "servers": { "kairos": { "type": "http", "url": "https://time-api-f6m3.onrender.com/mcp" } } }

The tools

A timer it can run, a ledger it can read

Each scope is yours to grant when you connect: the timer, invoicing, the workspace, or all three. A timer-only connection never sees an invoice, and nothing but the timer tools can be used without a manager’s role.

Timer

Start, stop, switch, log and fix time. The agent checks the client and project with you first.

What is the timer on?

You › “What am I working on?”

Redesign for Northwind, “PR review”, running 41 minutes.

Start the timer

You › “Switch to the Northwind redesign, nav rework.”

Stopped PR review at 41m. Started Redesign for Northwind: “Nav rework”.

Stop the timer

You › “Stop. Note: nav merged.”

Stopped Redesign for Northwind at 2h 10m: “Nav rework — nav merged”.

Log time

You › “Log 45 minutes on the quarterly report.”

Logged 45m on Quarterly report for Northwind.

Edit a time entry

You › “Move the last entry to Northwind / Redesign and make it 45 minutes.”

Would move it to Northwind / Redesign and make it 45m. Confirm? … Updated.

Delete a time entry

You › “Delete the second one.”

Would delete 1h 30m on Northwind / Redesign (Oct 26), “QA pass”. Confirm? … Deleted.

List projects

You › “What can I track against?”

Northwind / Redesign, Northwind / Quarterly report, and 4 more.

List clients

You › “Who do I bill?”

Northwind (2 projects), and 3 more clients.

Ledger

Read-only. Entries, reports and budgets come with the Timer scope; unbilled and invoices with Invoicing.

List time entries

You › “How many agent hours went into the redesign?”

All time on Northwind / Redesign: 4h 21m in 3 entries — 2h 11m by an assistant, 2h 10m by people.

Time report

You › “Time report for last month, by client.”

Last month: 61h across 3 clients — 19h by an assistant, 42h by people. Northwind 32h (assistant 11h, people 21h), $4,000; …

Budget or retainer standing

You › “How much of the Apex retainer is left this month?”

Apex Medical / Service Contract: 12h of 20h used this period, 8h left, 4 days left; on pace for 13.5h. Hours past the allowance bill at the hourly rate.

Dismiss a budget alert

You › “Clear that 80% warning.”

Dismissed the 80% alert on Northwind / Redesign.

What can be billed?

You › “What’s unbilled on Northwind?”

Northwind — 23.68 h in 14 entries and 1 expense, $3,000.00, from October 1 to 27.

List invoices

You › “Did Northwind pay the September invoice?”

Yes. Invoice #12 for Northwind — paid, $2,960.00.

Read an invoice’s lines

You › “What’s on invoice #13?”

1. Redesign, 18.5 h — $2,312.50. 2. Quarterly report, 5.18 h — $647.50.

Workspace

Set up the work. Owners and managers only; the rate is read back before anything is created.

Create a client

You › “New client Acme, billing@acme.com.”

Create the client Acme (billing@acme.com)? … Created. It has no projects yet.

Edit a client

You › “Acme moved to Denver.”

Set the city to Denver for Acme? … Updated.

Create a project

You › “Project Landing page for Acme at 150 an hour, and start the timer.”

Create Acme / Landing page at $150.00 an hour? … Created. Started Acme / Landing page.

Edit a project

You › “Make the Acme rate 175.”

Set the rate to $175.00 an hour (was $150.00) for Acme / Landing page? Unbilled hours are priced at the new rate. … Updated.

Archive a project

You › “Archive the Acme landing page.”

Archive Acme / Landing page? 2 entries stay on the record, 2 still unbilled. … Archived.

Expenses

Costs billed through to a client. Part of the Invoicing scope; owners and managers only.

Log an expense

You › “Log the $40 Figma seat to Northwind for October.”

Log $40.00 Figma seat for Northwind on 2026-10-15? … Logged. It’s unbilled and will be on Northwind’s next draft.

Edit an expense

You › “That was $45, not $40.”

Make it $45.00 (was $40.00)? … Updated.

List expenses

You › “What expense categories are there?”

2 expenses for Northwind, $65.00. Categories used: Software, Travel.

Invoices

Changes, each confirmed with you first. Owners and managers only.

Draft an invoice

You › “Invoice Northwind for October.”

Draft for Northwind: 2 lines and 1 expense, $3,000.00. Raise it?

Add, edit or remove a line

You › “Add a $500 deposit credit.”

Added “Deposit”, −$500.00. The draft is now $2,500.00.

Mark sent, paid or void

You › “Send #13.”

This emails Northwind through Stripe. Send it? … Invoice #13 for Northwind marked sent.

Team and settings

Read-only. The roster is for owners and managers; settings and feedback for everyone.

Who is on the team

You › “Who did the most hours this week?”

3 members of 5; hours this week: Ana (owner) 22h; Ben 18h; Assistant 9h (does not count as a member).

Who is on a project

You › “Who worked on Northwind this week and how much was the assistant?”

Northwind / Redesign, this week: Ana 3h; Ben 1h 30m of 10h planned; Assistant 2h 45m.

Workspace settings

You › “What timezone and currency is this workspace in?”

USD, invoices due in 30 days, time billed to the minute. Pro; 3 members of 5. Connected: Stripe. No workspace timezone — pass yours.

Send feedback to Kairos

You › “Tell Kairos I want recurring expenses.”

Thanks — passed on to the Kairos team: “I want recurring expenses”.

Ask your assistant

“What’s unbilled on Northwind?”
“Time report for last month, by client.”
“How much of the Apex retainer is left this month?”
“How many agent hours went into the redesign?”

What the assistant cannot do

Email an invoice itself. Marking one sent hands it to Stripe, and it asks you first.
Show money to anyone but owners and managers. A member’s connection sees hours.
Edit or delete time that is already on an invoice. Take the line off the draft, or void the invoice.
Log time as someone else, invite people, make tokens, or move money.

Everything else waits for your yes, except stopping the timer. It acts as you, in one workspace, and only within the scopes you granted; every hour it logs is marked as an assistant’s wherever hours appear.

Who it’s for

The agency

Agent hours, billed honestly

Five people and the agents they run, on one Pro subscription. Each agent’s session lands against the client it worked for, priced at the project’s rate and marked as an assistant’s, so you can see what the agents did before it goes on the invoice. Agents don’t count toward the 5 members.

The solo developer

Claude Code sessions, on the clock

Connect it once. “Start on Northwind, PR review” at the top of a session and “stop” at the end, and the hours are in the ledger without leaving the terminal. The note says what the session did.

Anyone, mid-afternoon

“What am I working on?”

Ask the assistant you already have open. It reads the timer and tells you what’s running and for how long, or reminds you that nothing is.

“I use Kairos every day. Part of it is laziness: Claude starts the timer, so I don’t have to remember. The bigger win is my clients’. The time is tracked to the minute instead of rounded up from memory, which saves them money, and every entry says what was actually done. They pay knowing what the hours bought.”

The founder of Kairos

Fourteen days on us. Then a dollar.

The connector works on every plan, trial included. If it isn’t for you, nothing was charged.

Get started

The full reference, with tokens and the HTTP API, is in the assistant guide.