让 Claude 直接查你的时间:TimeUno MCP Server 全接入指南

👉 工具网址:https://timeuno.io/mcp/

你有没有过这种瞬间:周五快下班了,脑子里突然冒出一个问题——这周的时间到底花哪儿了?

如果靠回忆,你大概率会高估“真正 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_summary
  • get_timeline
  • get_current_activity
  • get_projects

另外有四个可以替你执行操作的工具,但需要你允许:

  • pause_tracking
  • resume_tracking
  • add_note
  • set_productivity_rule

如果你是 Team owner 或 admin,还会多一个只读工具:

  • get_team_summary

get_team_summary 会返回成员时间、productive 分数、productive share 和 AI 时间。它不会返回 app、site 或屏幕信息。

如何接入 TimeUno MCP Server?

基本流程是:

  1. 在 AI 客户端里添加远程 MCP Server。
  2. 使用 URL:https://app.timeuno.io/mcp。
  3. 在浏览器中通过 OAuth 登录。
  4. 开始问你的时间数据。

你需要一个 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。

个人计划里的大致路径是:

  1. 打开 Customize。
  2. 进入 Connectors。
  3. 点击加号。
  4. 选择 Add custom connector。
  5. 给 connector 命名,例如 TimeUno。
  6. 粘贴远程 MCP Server URL:https://app.timeuno.io/mcp。
  7. 点击 Continue。
  8. 检查认证设置。
  9. 点击 Add。
  10. 在对话里通过 Connectors 旁边的加号打开它。

Team 或 Enterprise 计划里,可以由 Owner 在 Organization settings 里统一添加:

  1. 打开 Organization settings。
  2. 进入 Connectors。
  3. 添加远程 connector。
  4. 团队成员各自点击 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 端大致路径:

  1. 打开 Settings。
  2. 进入 Apps。
  3. 在 Advanced settings 里打开 developer mode。
  4. 创建一个 app。
  5. 粘贴 MCP Server URL:https://app.timeuno.io/mcp。
  6. 选择 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 没生效。

处理方式:

  1. 检查 URL 是否完全等于 https://app.timeuno.io/mcp。
  2. 移除旧 server 配置。
  3. 重新添加。
  4. 如果 OAuth 只在首次添加时触发,先完成登录流程。
  5. 如果涉及账号问题,查看 TimeUno FAQ:https://timeuno.io/faq/。

一次 MCP 调用会发送什么?

一次 MCP 调用通常会携带:

  • 你的 OAuth token。
  • 工具参数,例如日期、查询范围、备注文本。

TimeUno 会用已经记录的时间来回答,不会因为一个查询就开启新的追踪。

AI app 只会拿到工具返回的数据,例如:

  • 汇总时间。
  • 时间线条目。
  • 项目名。
  • 当前活动。

MCP tools 不会返回截图,TimeUno 也不保存截图。

不过要注意:只要某个工具返回的内容进入了 AI 对话,它就会受该 AI 服务商自己的条款约束。连接前值得快速看一眼相关 provider 政策。

如果你想断开连接:

  1. 打开 TimeUno dashboard。
  2. 进入 Settings。
  3. 找到 Connected AI apps。
  4. 点击 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。
  • 不能像手动追踪工具那样,仅凭聊天内容替你新建一段工作时间。
  • 它更擅长回答“时间去了哪里”,而不是替你编造工作日志。

接入后第一周应该问什么?

建议从只读问题开始,并且最好先积累几天真实数据。刚安装的新账号能回答的内容会很少。

可以从这几个问题开始:

  1. “总结一下上周我的时间分配,我来跟自己的记忆对一对。”
  2. “列出昨天的时间线,让我看看 app、site、项目和分类是否合理。”
  3. “这周哪个项目比上周更耗时间?”
  4. “我最近这周的 AI tool time 有多少?”
  5. “我现在正在做什么?追踪是不是暂停了?”

等你确认读取结果没问题后,再考虑开放写入工具,例如 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 是一个低接入成本、偏读取、适合做时间复盘的开发者友好选择。

直达网址:https://timeuno.io/mcp/

more