Clockflux

New in Pro: ask your AI assistant about your hours

4 min read

You're halfway through a task with an AI assistant open next to it, and you wonder how many hours you've put in this week. Until now that meant switching to Clockflux, finding the right week and reading it off. From today, if you're on Clockflux Pro, you can just ask the assistant.

This is the first release note on the blog. What we're building next is on the work-in-progress page.

What's new

Clockflux now runs an MCP server. MCP, the Model Context Protocol, is an open-source standard for connecting AI applications to outside systems, and most of the popular assistants and coding tools support it. Once you connect yours to Clockflux, it can read your tracked hours and days off, and check you in or out when you ask it to.

It's part of Clockflux Pro and works with the same data you see in the app, on every device you've signed in on.

What you can ask

You talk to the assistant as you normally would. A few examples:

  • "Am I checked in? How long have I worked today?"
  • "How many hours did I work last week, and which day was the longest?"
  • "Did I work any late evenings in October?"
  • "How many vacation days have I taken this year, and how many of them were half days?"
  • "Check me in." Then later: "Check me out."

Behind the scenes the assistant gets your sessions for the period you asked about, your daily target, your weekend days and your days off, and works out the answer from there. Hours come back in decimal, the same as in the app, so 7.5 means seven and a half hours.

When you check in or out from an assistant, it goes through cloud sync like a change made on any of your other devices. Open Clockflux on your phone a minute later and the session is there.

What it won't do

We've kept the first version deliberately small.

  • It can't change your history. An assistant can read your past entries and start or end today's session. It can't edit an old session, delete one or book days off. You still do those in the app.
  • It follows the same rules as the app. Clockflux won't check you in on one of your weekend days or on a full day off, or while you're already checked in, and neither will an assistant. It will tell you why instead.
  • It doesn't calculate your overtime balance or exact holiday balance. Those depend on things like your accrual mode and carryover, and the Health view and Holiday tab in the app remain the place for them. The assistant can still add up hours and count days off for you.

Which assistants work

You can connect Claude Code, Claude Desktop, Cursor, VS Code with GitHub Copilot, the Codex CLI and the Gemini CLI. Any other MCP client that can reach a remote server with a token should work too.

The claude.ai website, the Claude mobile apps and ChatGPT can't connect yet. They need a sign-in flow that Clockflux doesn't support so far. We'll write about it here if that changes.

How to connect one

  1. In the app, open Settings and go to AI assistants.
  2. Create a token and give it a name you'll recognise, like "Cursor on my work laptop".
  3. Copy the token straight away. It's shown once and never again.
  4. Pick your assistant. Clockflux shows the exact command or settings snippet for it, with your token already filled in, and links to that assistant's own setup docs.

The Pro docs go through the same steps.

Your token and your data

A token works like a password for one assistant, so we've tried to treat it like one.

We only store a fingerprint of each token, not the token itself, which is why we can't show it to you again after you've copied it. If you lose one, revoke it and create a new one. The list in Settings shows when each token was last used, so an old one you've forgotten about is easy to spot and remove.

We suggest one token per assistant. That way you can cut off a single one, say on a laptop you've handed back, without disconnecting the others. Tokens also stop working straight away if your Pro plan ends, and deleting your Clockflux account revokes all of them.

One thing worth knowing before you connect: when you ask an assistant about your hours, it reads them so it can answer you. From then on, that information is part of your conversation with that assistant, and the AI company's own privacy terms apply to it, not ours. The privacy notice covers what Clockflux itself keeps.

Try it

If you're already on Pro, the AI assistants section is in Settings now. If you're not, the Pro docs list everything else it includes, and the pricing page has the current price.

We'd like to hear what you end up asking it. The questions people actually ask will decide what we add next.