TimeUno MCP server
Read your tracked time and projects, pause tracking or add a note, from Clineor any other MCP client.
TimeUno is an automatic time tracker for people who workacross apps, sites and AI coding tools. Its MCP server lets your AI assistantanswer questions like "How much of today was productive?" or "What did I workon this week?" from your real tracked time, and act for you: pause or resumetracking, add a note, or mark an app or site as productive.
The server is hosted by TimeUno. There is nothing to clone, build or runlocally, and no API key to copy.
Requirements
- A TimeUno account with an active trial or plan. Start the 14-day free trialat https://timeuno.io. Every tool refuses when the workspace has no livetrial or plan.
- An MCP client that supports Streamable HTTP and OAuth (Cline does).
Server
| URL | https://app.timeuno.io/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 with Dynamic Client Registration and PKCE |
| Scopes | timeuno:read, timeuno:write, offline_access |
Install in Cline
Remote Servers tab
- In the Cline panel, click the MCP Servers icon.
- Open Remote Servers.
- Server Name:
timeuno. Server URL:https://app.timeuno.io/mcp.Transport Type: Streamable HTTP. - Click Add Server.
- Cline opens TimeUno in your browser. Sign in, check that the app is Cline,and click Allow.
Settings file
Add this to cline_mcp_settings.json (MCP Servers > Configure >Configure MCP Servers; for Cline CLI it is~/.cline/data/settings/cline_mcp_settings.json):
{
"mcpServers": {
"timeuno": {
"type": "streamableHttp",
"url": "https://app.timeuno.io/mcp",
"disabled": false,
"autoApprove": []
}
}
}
Keep "type": "streamableHttp". Without it Cline uses the legacy SSEtransport, which this server does not serve.
Then authorize in the browser when Cline asks. In Cline CLI, run cline mcpand choose Authorize OAuth.
Other clients
Any client that supports remote MCP servers with OAuth connects with the sameURL. For example:
claude mcp add --transport http timeuno https://app.timeuno.io/mcp
Cursor users can install the TimeUno plugin for Cursor.
Tools
Read tools (scope timeuno:read):
| Tool | What it answers |
|---|---|
get_summary |
A day, week or month: time tracked, productivity score, productive share, focus, AI and idle time, top categories, apps, sites and projects. |
get_timeline |
A day as a list of activity runs, with app or site, window title, category, verdict and project. |
get_current_activity |
What you are doing right now, and whether tracking is paused. |
get_projects |
Time per project for a week, with the week before for comparison. |
get_team_summary |
For team owners and admins: each member's time, productivity score, productive share and AI time. Never apps, sites or screens. |
Write tools (scope timeuno:write):
| Tool | What it does |
|---|---|
pause_tracking |
Pauses tracking for a number of minutes, or until resumed, on every device. |
resume_tracking |
Resumes tracking on every device. |
add_note |
Adds a note to the activity timeline. |
set_productivity_rule |
Makes an app or site always count as productive or unproductive; updates past matching time too. |
The read tools are safe to auto-approve. Leave the write tools on manualapproval if you want to confirm each change.
Example prompts
- "How much of today was productive?"
- "What did I work on this week, per project?"
- "Pause tracking for 30 minutes."
- "Always count figma.com as productive."
Privacy and data
The server only returns data from your own TimeUno workspace, after youapprove the connection on a TimeUno consent screen. You can revoke it inTimeUno settings at any time.
- Setup and data handling: https://timeuno.io/mcp/
- Developer docs: https://timeuno.io/docs/developers/mcp/
- Privacy: https://timeuno.io/privacy/
Support
License
MIT. This repository holds the documentation for the hosted server.