Toggl 自动化 - 智能时间追踪技能

技能概述

通过自然语言命令自动化管理 Toggl Track 时间记录，无需离开终端即可创建时间条目、管理项目客户、组织标签和控制工作空间。

适用场景

1. 开发者日常时间记录

在编程工作流中快速记录时间，无需切换到浏览器或移动应用。通过简单命令即可为当前项目添加时间条目，关联任务和标签，保持时间追踪的连续性和准确性。

2. 项目经理团队时间管理

批量创建和管理项目及客户信息，查看团队成员的时间分配情况。通过自然语言查询工作空间状态，快速获取项目详情和统计数据，提高团队时间管理效率。

3. 自由职业者计费时间追踪

精确记录客户项目时间，自动关联项目和客户信息，确保计费时间的准确性。通过标签组织不同类型的工作内容，生成清晰的时间记录用于发票和报告。

核心功能

时间条目管理

创建和停止计时器，支持项目关联、任务分配、标签添加和描述填写。可以一次性创建已完成的时间条目，或启动计时器实时追踪工作时长。所有操作通过自然语言命令完成，时间格式灵活支持。

项目与客户管理

在工作空间中创建新项目，设置计费状态、颜色标记和预估工时。批量查询项目列表，获取包含客户详情的完整信息。同时支持客户信息的创建和查询，帮助建立完整的项目-客户关系体系。

工作空间与标签管理

列出所有可访问的工作空间及其元数据，获取工作空间偏好设置。管理标签用于时间条目分类，支持标签列表查询和验证。这些功能帮助组织复杂的多工作空间环境，确保时间记录的一致性。

常见问题

Toggl Automation 支持哪些功能？

支持创建和停止时间条目、管理项目和客户、查询工作空间和标签、获取用户可见项目等核心操作。几乎涵盖了 Toggl Track API 的主要功能，包括批量查询、项目详情获取和工作空间偏好设置。

如何在 Claude Code 中配置 Toggl 自动化？

需要将 Rube MCP 服务器添加到 Claude Code 配置中，使用 URL https://rube.app/mcp。配置后会提示通过连接链接认证 Toggl Track 账户，完成认证后即可使用自然语言命令进行时间追踪自动化操作。

Toggl Automation 有什么使用限制？

大多数功能都需要工作空间 ID 作为必需参数，建议先调用工作空间查询功能获取 ID。时间条目的标签使用名称而非 ID，需要注意区分。部分高级功能如自定义颜色、固定费用等需要 Toggl 付费账户支持。