DEV Community

Kobe Cuppens for TimeUno

Posted on Originally published at timeuno.io

Time tracking MCP server and how to ask Claude about your time

What is a time tracking MCP server?

A time tracking MCP server lets an AI assistant such as Claude, ChatGPT or Cursor read your tracked time and answer from it instead of guessing. MCP (Model Context Protocol) is an open standard for connecting AI apps to outside tools. The server exposes named tools, and the assistant calls one when your question needs data.

Last reviewed: November 2026.

I work on TimeUno, an automatic time tracker for macOS and Windows that records the app in front, window titles and AI tool sessions. It runs a remote MCP server at https://app.timeuno.io/mcp. You add the URL to your AI app once, sign in, and ask about your day in plain language. This post covers what you can ask, how to connect five clients, what a call sends, and which other trackers have an MCP server. The MCP page has the current docs.

Why use MCP instead of a CSV export or an API?

A CSV export is a snapshot you download, upload and re-explain every time. A REST API needs code and a key. With MCP the assistant discovers the tools itself, calls them live and asks for your consent first.

MCP suits short, repeated questions such as "where did Tuesday go?". For a report you hand to a client, a CSV or PDF timesheet export from the app is the better artifact. Those are the only two export formats TimeUno has.

What can you ask your tracked time?

You can ask anything the tools return: totals for a day, week or month, a timeline of activity runs, the current activity, and time per project. The data comes from time TimeUno already tracked. A question does not start a new capture.

Question Tool
How much of today was productive? get_summary (one day)
What did I work on this week? get_summary (a week, with top apps, sites and projects)
Walk me through yesterday as a list. get_timeline (app or site, window title, category, verdict, project)
What am I doing right now, and is tracking paused? get_current_activity
Which project took more time than last week? get_projects (includes the week before)
How much of this week was AI tool time? get_summary (reports AI and idle time)

Four tools are read only. Four more can act for you, and only if you allow them: pause_tracking, resume_tracking, add_note and set_productivity_rule. Team owners and admins get one extra read tool, get_team_summary, which returns each member's time, productivity score, productive share and AI time. It never returns apps, sites or screens.

How do you connect the TimeUno MCP server?

Add https://app.timeuno.io/mcp as a remote server in your AI app, then sign in with OAuth in the browser. You need a TimeUno account with an active trial or plan. The trial is 14 days and needs no card.

Claude Code

Run this in a terminal, then type /mcp inside Claude Code and follow the sign-in prompt:

claude mcp add --transport http timeuno https://app.timeuno.io/mcp
Enter fullscreen mode Exit fullscreen mode

Check it with claude mcp list. By default Claude Code keeps the server private to you in the current project. Add --scope user to make it available in every project. Anthropic's Claude Code MCP documentation lists the scopes and claude mcp remove.

Cursor

Add a remote server to ~/.cursor/mcp.json for all projects, or to .cursor/mcp.json inside one project. Cursor supports Streamable HTTP and OAuth, so the URL is enough:

{
  "mcpServers": {
    "timeuno": {
      "url": "https://app.timeuno.io/mcp"
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

See the Cursor MCP documentation.

Codex CLI

codex mcp add timeuno --url https://app.timeuno.io/mcp
codex mcp login timeuno
Enter fullscreen mode Exit fullscreen mode

The Codex CLI and IDE extension share one configuration in ~/.codex/config.toml, described in OpenAI's Codex MCP documentation. Check OpenAI's current docs for whether the ChatGPT desktop app reads the same file.

Claude on the web and desktop

Per Anthropic's custom connectors guide, custom connectors are available on Free (limited to one), Pro, Max, Ultra, Team and Enterprise plans as of November 2026. On an individual plan, go to Customize, then Connectors, click the plus button and choose Add custom connector. Name it TimeUno, paste the server URL, click Continue, review the authentication settings and click Add. Then switch it on per conversation with the plus button under Connectors.

On Team or Enterprise, an Owner adds it once under Organization settings, then Connectors, and each member clicks Connect. Claude connects from Anthropic's cloud, so the server must be reachable from the internet. The TimeUno URL is public, so this works.

ChatGPT

ChatGPT needs developer mode to add a custom MCP server. In the web app, open Settings, then Apps, turn on developer mode under Advanced settings, create an app, paste the server URL and choose OAuth. On Business and Enterprise workspaces an admin may need to allow it first. OpenAI renames these menus often, so check its developer mode help article if a label differs.

Any other client

Pick the option for a remote server over Streamable HTTP, paste the URL and choose OAuth if asked. A client that only supports local stdio servers cannot use this server directly.

What if it does not connect?

Most failures have one of three causes: a typo or trailing character in the URL, a client that only supports local servers, or a TimeUno trial or plan that is not active. Fix the cause, then remove the server and add it again. Some clients run the sign-in flow only when a server is first added. The FAQ covers account questions.

What does an MCP call send?

A call carries your OAuth token and its arguments, such as a date or a note's text. TimeUno answers from time it already tracked. The AI app gets only what the tool returns: totals, timeline entries, project names and the current activity. No tool returns screenshots, and TimeUno saves none.

Whatever a tool returns does enter the assistant's conversation, so it falls under that provider's own terms. Read those before you connect, as you would for any connector.

To disconnect, open Settings, then Connected AI apps, in the TimeUno dashboard and click Disconnect. Access ends at once. If your plan ends, the tools stop answering until a plan is active again.

Is it safe to let an AI app read your time?

The risk is low when you start the connection yourself. The sign-in page shows the app's name and the permissions it asks for. Check those, then click Allow.

If a TimeUno Allow page opens and you did not just add the server, click Deny. Someone else may be trying to link their app to your account. If an app asks to act for you and you only want it to read, click Deny too.

Anthropic also warns to trust a server before connecting it and to watch for prompt injection, where text inside a tool result tries to steer the assistant. Keep tool approvals on and read what the assistant is about to do before you accept a write.

Which time trackers have an MCP server?

Seven of the nine below have one live, and Clockify lists one as coming soon. The table lists what each vendor's own page says as of November 2026. Setup and limits differ, so check the source before you pick.

Tracker MCP server Notes Source
TimeUno Yes, remote OAuth sign-in. Read tools plus pause, note and rule tools. No free tier. timeuno.io/mcp
Toggl Yes Logs time, manages tasks, runs reports. Creates, updates and deletes need confirmation. toggl.com/ai/mcp
Clockify Coming soon API key. Time entries and reports for projects you can access. Help page was labeled "Coming soon" at this check. Clockify Help
Harvest Yes Start and stop timers, log hours, review time. Check the article for plan limits. Harvest Help Center
Timing (Mac) Yes, two servers One built into the Mac app (beta), one web server. Needs a Timing Connect plan. timingapp.com/help/mcp
Rize Yes, remote https://mcp.rize.io/mcp, OAuth. Time entries, projects and clients. Rize MCP guide
Dayflow (Mac) Yes, local Set up from Settings, MCP / CLI. Reads local data, with an Allow edits switch. dayflow.so/integrations
WakaTime Not found No MCP page on wakatime.com (home, features and developers pages checked). wakatime.com/developers
RescueTime Yes, remote Mostly read access, and its MCP API keys are read-only. Focus sessions and categorizing need extra permissions. RescueTime MCP guide

The main split is manual versus automatic. Manual trackers such as Toggl, Clockify and Harvest let the assistant log and edit entries, so you still have to tell it what you did. Automatic trackers such as TimeUno, RescueTime and Rize mostly let it read what was already recorded.

TimeUno is automatic and covers macOS and Windows, plus a headless Linux agent for servers. It records AI tool sessions (Claude Code, Cursor, Codex CLI and others) next to your own app time. It has no mobile app and no free tier, and it will not log time for you from a chat the way a manual tracker can.

What should you ask first?

Start with read-only questions and a few days of real data. A fresh install has little to answer from.

  1. Ask for a summary of last week and compare it with your memory.
  2. Ask for yesterday's timeline and check the project names.
  3. Ask which project moved most against the week before.
  4. Only then allow write access and try a note or a pause.

To try it, download TimeUno and start the 14-day trial, or read the pricing first. Individual is $9.99 a month and Team is $12.99 per seat per month, as of November 2026.

Questions

What does an MCP server do for a time tracker?

It lets an AI assistant read your tracked time and answer from it instead of guessing. The assistant calls named tools, such as TimeUno's get_summary or get_timeline.

How do you connect TimeUno to Claude or Cursor?

Add https://app.timeuno.io/mcp as a remote server and sign in through OAuth in the browser. In Claude Code the command is claude mcp add --transport http timeuno https://app.timeuno.io/mcp. In Cursor you add a url entry to mcp.json.

Can an AI assistant change my TimeUno data?

Only in small ways, and only if you allow it. The write tools pause or resume tracking, add a note, or mark an app or site as productive or unproductive. They cannot edit or delete tracked entries.

Is there a free time tracker with an MCP server?

Toggl says its MCP server is on all plans, including free, but I did not verify that beyond its page. TimeUno has no free tier, only a 14-day trial with no card.

Which time trackers have an MCP server?

Toggl, Harvest, Timing, Rize, Dayflow, RescueTime and TimeUno have one live, as of November 2026. Clockify's page was marked "Coming soon", and WakaTime had none on its site.


I work on TimeUno, the tool this post discusses. The full version is at https://timeuno.io/blog/time-tracking-mcp-ask-claude-about-your-time.

Top comments (0)