让 Claude 直接查你的时间:TimeUno MCP Server 全接入指南
你有没有过这种瞬间:周五快下班了,脑子里突然冒出一个问题——这周的时间到底花哪儿了?
如果靠回忆,你大概率会高估“真正 productive 的时间”。如果靠手动补录,又会很烦。TimeUno MCP Server 的思路很简单:让 AI 应用直接读取你已经记录下来的时间数据,然后用你习惯的自然语言问它。
截至 2026 年 11 月,TimeUno 的远程 MCP Server 地址是:
https://app.timeuno.io/mcp
只要把它添加到 Claude、ChatGPT、Cursor、Codex CLI 等支持远程 MCP 的客户端,然后浏览器里 OAuth 登录一次,你就可以直接问:
- “昨天我主要做了什么?”
- “这周哪几个项目最耗时?”
- “今天 productive 时间有多少?”
- “AI 工具会话占了多少时间?”
- “我现在是不是处于追踪状态?”
什么是 time tracking MCP server?
MCP,全称 Model Context Protocol,是一个开放标准,用来把 AI 应用连接到外部工具。
你可以把它理解成“AI 和工具之间的通用插座”。AI 应用不需要自己硬编码某个服务的 API,只要接入一个 MCP Server,就能发现这个服务提供了哪些工具,然后在你需要时调用。
比如:
get_summary:读取汇总时间。get_timeline:读取时间线。get_current_activity:查看当前活动。get_projects:查看项目耗时。
你问一句,AI 就会根据这些工具去查数据,而不是瞎猜。
为什么不直接用 CSV 导出或 API?
CSV 导出的问题在于:它是一次性快照。你需要导出、上传、重新解释,AI 才能继续工作。每次问新问题,流程都会重来一遍。
REST API 更强,但你通常要写代码、管理 key、处理授权、拼请求。对于“今天去哪了”这种小问题,成本有点高。
MCP 更适合:
- 高频小问题。
- 多轮对话。
- 让 AI 自己发现可用工具。
- 在执行前向你确认权限。
- 实时读取已记录的时间。
但如果你要给客户交正式报表,CSV 或 PDF 时间账单仍然更合适。TimeUno 当前只提供这两种导出格式。
你可以问 AI 什么?
你可以问任何 MCP 工具能返回的数据。比如:
-
“今天 productive 的时间有多少?”
对应get_summary,查看一天汇总。 -
“这周我做了哪些事?”
对应get_summary,可以查看 top apps、top sites、top projects。 -
“给我按时间线讲一下昨天干了什么。”
对应get_timeline,可以查看 app 或 site、窗口名、分类、判定结果、项目归属。 -
“我现在正在干什么?追踪暂停了吗?”
对应get_current_activity。 -
“哪个项目比上周更耗时间?”
对应get_projects,会包含上一周对比数据。 -
“这周有多少时间花在 AI 工具上?”
对应get_summary,其中包含 AI 时间和 idle 时间。
TimeUno 有四个只读工具:
get_summaryget_timelineget_current_activityget_projects
另外有四个可以替你执行操作的工具,但需要你允许:
pause_trackingresume_trackingadd_noteset_productivity_rule
如果你是 Team owner 或 admin,还会多一个只读工具:
get_team_summary
get_team_summary 会返回成员时间、productive 分数、productive share 和 AI 时间。它不会返回 app、site 或屏幕信息。
如何接入 TimeUno MCP Server?
基本流程是:
- 在 AI 客户端里添加远程 MCP Server。
- 使用 URL:
https://app.timeuno.io/mcp。 - 在浏览器中通过 OAuth 登录。
- 开始问你的时间数据。
你需要一个 TimeUno 账号,并且 trial 或 plan 是有效状态。TimeUno 提供 14 天试用,不需要绑定信用卡。
Claude Code 接入方式
如果你用的是 Claude Code,可以在终端里直接添加远程 MCP Server:
# 添加 TimeUno 远程 MCP Server,让 Claude Code 可以读取你的追踪时间
claude mcp add --transport http timeuno https://app.timeuno.io/mcp
# 检查已经添加的 MCP Server 是否可用
claude mcp list
默认情况下,Claude Code 会把当前项目的 MCP Server 设置成项目级私有。如果你希望在所有项目里都能用,可以加:
# 让 TimeUno MCP Server 对当前用户的所有项目都可用
claude mcp add --transport http timeuno https://app.timeuno.io/mcp --scope user
之后在 Claude Code 里输入:
/mcp
按照提示完成浏览器登录即可。
Anthropic 的 Claude Code MCP 文档里有 scope 和 claude mcp remove 的说明:
https://code.claude.com/docs/en/mcp
Cursor 接入方式
如果你用的是 Cursor,可以添加一个远程 server。
全局配置放在:
~/.cursor/mcp.json
项目内配置放在:
.cursor/mcp.json
Cursor 支持 Streamable HTTP 和 OAuth,所以通常只要填入 URL:
// Cursor MCP 远程 server 配置:
// 这里把 TimeUno 的 MCP Server 地址告诉 Cursor。
// 添加后 Cursor 会尝试通过浏览器 OAuth 让你登录 TimeUno。
{
"mcpServers": {
"timeuno": {
// TimeUno 远程 MCP Server 地址,必须使用 https
"url": "https://app.timeuno.io/mcp"
}
}
}
Cursor MCP 文档:
https://cursor.com/docs/mcp
Codex CLI 接入方式
Codex CLI 可以用命令行添加 TimeUno MCP Server:
# 添加 TimeUno MCP Server 到 Codex CLI
codex mcp add timeuno --url https://app.timeuno.io/mcp
# 启动 OAuth 登录,让 Codex CLI 获得读取你 TimeUno 时间数据的权限
codex mcp login timeuno
Codex CLI 和 IDE extension 共用配置:
~/.codex/config.toml
如果你用的是 OpenAI Codex 相关文档,建议查看当前最新的 Codex MCP 文档,确认 ChatGPT 桌面端是否读取同一配置。
Claude Web / Desktop 接入方式
在 Claude Web 和桌面端里,可以添加 custom connector。
根据 Anthropic 的 custom connectors 指南,截至 2026 年 11 月,自定义 connector 支持以下计划:
- Free:限制一个 connector。
- Pro。
- Max。
- Ultra。
- Team。
- Enterprise。
个人计划里的大致路径是:
- 打开 Customize。
- 进入 Connectors。
- 点击加号。
- 选择 Add custom connector。
- 给 connector 命名,例如 TimeUno。
- 粘贴远程 MCP Server URL:
https://app.timeuno.io/mcp。 - 点击 Continue。
- 检查认证设置。
- 点击 Add。
- 在对话里通过 Connectors 旁边的加号打开它。
Team 或 Enterprise 计划里,可以由 Owner 在 Organization settings 里统一添加:
- 打开 Organization settings。
- 进入 Connectors。
- 添加远程 connector。
- 团队成员各自点击 Connect。
注意:Claude 会从 Anthropic 云端连接你的 MCP Server,所以 server URL 必须能从公网访问。TimeUno 使用的是公开地址,因此可以正常连接。
Anthropic custom connector 指南:
https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp
ChatGPT 接入方式
ChatGPT 添加自定义 MCP server 需要 developer mode。
Web 端大致路径:
- 打开 Settings。
- 进入 Apps。
- 在 Advanced settings 里打开 developer mode。
- 创建一个 app。
- 粘贴 MCP Server URL:
https://app.timeuno.io/mcp。 - 选择 OAuth 认证。
如果是 Business 或 Enterprise workspace,管理员可能需要先允许这类 app。
OpenAI 的菜单名称可能会变化,建议参考官方帮助:
https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt
其他 AI 客户端如何接入?
只要你的客户端支持:
- Remote MCP Server。
- Streamable HTTP。
- OAuth。
就可以添加:
https://app.timeuno.io/mcp
添加时选择 OAuth,然后完成浏览器授权。
如果你的客户端只支持本地 stdio MCP server,就不能直接连接这个远程地址。
连不上怎么办?
大多数失败原因集中在三类:
- URL 拼错了,或者末尾多了一个空格、斜杠、换行符。
- 客户端只支持本地 stdio server,不支持 remote HTTP MCP。
- TimeUno trial 或 plan 没生效。
处理方式:
- 检查 URL 是否完全等于
https://app.timeuno.io/mcp。 - 移除旧 server 配置。
- 重新添加。
- 如果 OAuth 只在首次添加时触发,先完成登录流程。
- 如果涉及账号问题,查看 TimeUno FAQ:
https://timeuno.io/faq/。
一次 MCP 调用会发送什么?
一次 MCP 调用通常会携带:
- 你的 OAuth token。
- 工具参数,例如日期、查询范围、备注文本。
TimeUno 会用已经记录的时间来回答,不会因为一个查询就开启新的追踪。
AI app 只会拿到工具返回的数据,例如:
- 汇总时间。
- 时间线条目。
- 项目名。
- 当前活动。
MCP tools 不会返回截图,TimeUno 也不保存截图。
不过要注意:只要某个工具返回的内容进入了 AI 对话,它就会受该 AI 服务商自己的条款约束。连接前值得快速看一眼相关 provider 政策。
如果你想断开连接:
- 打开 TimeUno dashboard。
- 进入 Settings。
- 找到 Connected AI apps。
- 点击 Disconnect。
断开后访问立即失效。如果你的 plan 过期,这些工具也会停止返回结果,直到 plan 重新有效。
让 AI 读取你的时间安全吗?
只要是你主动发起连接,风险相对可控。
OAuth 登录页通常会显示:
- 正在请求连接的应用名称。
- 它会获得的权限。
- 是只读,还是可以执行某些操作。
建议这样做:
- 看清授权请求再点 Allow。
- 如果你并没有刚刚添加 server,却突然弹出 TimeUno Allow 页面,点 Deny。
- 如果只想让 AI 读数据,却遇到 write 权限请求,也点 Deny。
- 保留 tool approvals。
- 在 AI 执行写入操作前,读一下它准备做什么。
Anthropic 也提醒开发者信任一个 server 前要先确认,并警惕 prompt injection。简单说,就是工具返回的文本里可能藏着试图操控 AI 的内容。对时间追踪这种低风险数据来说,主要风险仍然来自“意外授权写入”。
哪些时间追踪工具有 MCP server?
截至 2026 年 11 月,根据各厂商自己的页面,大致情况如下:
- TimeUno:有 remote MCP server。支持 OAuth。提供读取工具,也有 pause、note、rule 等操作工具。没有 free tier。
- Toggl:有 MCP server。可以记录时间、管理任务、跑报表。创建、更新、删除通常需要确认。
- Clockify:帮助页显示 coming soon。预期会用 API key,读取用户可访问项目的时间条目和报表。
- Harvest:有 MCP server。可以 start/stop timer、记录小时、查看时间。具体受 plan 限制,要看官方文章。
- Timing for Mac:有两个 server。一个是 Mac app 内置 beta server,另一个是 web server。需要 Timing Connect plan。
- Rize:有 remote MCP server,地址是
https://mcp.rize.io/mcp。支持 OAuth,可查看时间条目、项目和客户。 - Dayflow for Mac:有 local MCP server。在 Settings 的 MCP / CLI 区域配置。读取本地数据,有 Allow edits 开关。
- WakaTime:截至检查时间,官方页面没有看到 MCP server。
- RescueTime:有 remote MCP server。主要是读取权限,MCP API key 默认是 read-only。focus sessions 和 categorizing 需要额外权限。
相关来源:
- TimeUno MCP:
https://timeuno.io/mcp/ - Toggl AI/MCP:
https://toggl.com/ai/mcp - Clockify MCP Help:
https://clockify.me/help/integrations-and-add-ons/use-clockify-mcp-server-to-connect-to-ai-agent - Harvest MCP Help:
https://support.getharvest.com/hc/en-us/articles/46293697226381-Harvest-MCP - Timing MCP Help:
https://timingapp.com/help/mcp - Rize MCP Guide:
https://rize.io/guides/mcp-ai-assistants - Dayflow Integrations:
https://www.dayflow.so/integrations/ - WakaTime Developers:
https://wakatime.com/developers/ - RescueTime MCP Guide:
https://www.rescuetime.com/mcp-guide
手动追踪和自动追踪有什么不同?
核心区别在于“数据是谁写进去的”。
手动追踪类工具,例如:
- Toggl。
- Clockify。
- Harvest。
它们允许 AI 帮你记录、编辑条目。但你仍然要告诉 AI 自己刚才做了什么。
自动追踪类工具,例如:
- TimeUno。
- RescueTime。
- Rize。
- Dayflow。
- Timing。
它们主要让 AI 读取已经自动记录下来的时间。你不需要每五分钟手动打点。
TimeUno 是自动追踪工具,支持 macOS 和 Windows,也有 headless Linux agent 可用于服务器。它会把 AI 工具会话,比如 Claude Code、Cursor、Codex CLI 等,记录成可查询的活动。
TimeUno 的限制也要说清楚:
- 没有 mobile app。
- 没有 free tier。
- 不能像手动追踪工具那样,仅凭聊天内容替你新建一段工作时间。
- 它更擅长回答“时间去了哪里”,而不是替你编造工作日志。
接入后第一周应该问什么?
建议从只读问题开始,并且最好先积累几天真实数据。刚安装的新账号能回答的内容会很少。
可以从这几个问题开始:
- “总结一下上周我的时间分配,我来跟自己的记忆对一对。”
- “列出昨天的时间线,让我看看 app、site、项目和分类是否合理。”
- “这周哪个项目比上周更耗时间?”
- “我最近这周的 AI tool time 有多少?”
- “我现在正在做什么?追踪是不是暂停了?”
等你确认读取结果没问题后,再考虑开放写入工具,例如 add_note 或 pause_tracking。
TimeUno 价格截至 2026 年 11 月为:
- Individual:$9.99 / 月。
- Team:$12.99 / seat / 月。
试用入口:
https://timeuno.io/download/
价格页:
https://timeuno.io/pricing/
提米哥选品视角
TimeUno MCP Server 的价值不是“再做一个报表”,而是把时间数据变成 AI 可读取的上下文。
它特别适合这类开发者场景:
- 每周复盘,想知道时间到底被什么 app 吃掉了。
- 做 AI coding 时,希望知道 Claude Code、Cursor、Codex CLI 会话占了多少真实耗时。
- 不想手动填时间日志,但又想让 AI 能回答“我昨天干了什么”。
- 想把时间数据接入自己的 workflow,让 AI 助手基于真实活动给建议。
一句话总结:
如果你想让 AI 不再靠猜来回答你的时间问题,TimeUno MCP Server 是一个低接入成本、偏读取、适合做时间复盘的开发者友好选择。