⚡

Toggl自动化Skill TogglAutomation

Toggl 自动化是一个工具包，用于在 Toggl Track 中自动化时间跟踪工作流。它允许用户通过自然语言命令创建时间条目、管理项目和客户端、组织标签及控制工作空间，提升工作效率和自动化水平。关键词：时间跟踪、自动化、Toggl、项目管理、工作流管理、生产效率工具。

低代码开发 0 次安装 0 次浏览 更新于 3/12/2026

name: Toggl Automation description: “在 Toggl Track 中自动化时间跟踪工作流——通过自然语言命令创建时间条目、管理项目、客户端、标签和工作空间。” requires: mcp: - rube

Toggl 自动化

直接从 Claude Code 自动化您的 Toggl Track 时间跟踪操作。记录时间、管理项目和客户端、使用标签进行组织、控制工作空间——所有这些都无需离开终端。

工具包文档: composio.dev/toolkits/toggl

设置

  1. 将 Rube MCP 服务器添加到您的 Claude Code 配置中，URL: https://rube.app/mcp
  2. 当提示时，通过提供的连接链接验证您的 Toggl Track 账户
  3. 开始使用自然语言自动化您的时间跟踪工作流

核心工作流

1. 创建和停止时间条目

记录带有项目、任务和标签关联的时间，或开始/停止计时器。

工具: TOGGL_CREATE_TIME_ENTRY, TOGGL_PATCH_STOP_TIME_ENTRY

在工作空间 123456 中为项目 78910 创建时间条目，标签为 "meeting" 和 "design"，描述为 "Design review session"

TOGGL_CREATE_TIME_ENTRY 的关键参数:

  • workspace_id (必需) —— 目标工作空间
  • created_with (必需) —— 客户端应用程序名称（例如，"api_client"）
  • start (必需) —— ISO 8601 时间戳
  • stop —— ISO 8601 结束时间；省略以使条目运行
  • duration —— 持续时间（秒）；省略以运行条目
  • project_id —— 关联到项目
  • task_id —— 关联到任务
  • tags —— 标签名称字符串数组（非 ID）
  • description —— 工作描述
  • billable —— 可计费状态

TOGGL_PATCH_STOP_TIME_ENTRY 的关键参数:

  • workspace_id (必需) 和 time_entry_id (必需)

2. 管理项目

创建新项目并列出带有客户端详情和分页的现有项目。

工具: TOGGL_CREATE_PROJECT, TOGGL_GET_PROJECTS, TOGGL_GET_PROJECT_DETAILS

在工作空间 123456 中为客户端 78910 创建一个名为 "Q1 Marketing Campaign" 的私有可计费项目

TOGGL_CREATE_PROJECT 的关键参数:

  • workspace_id (必需) 和 name (必需)
  • client_id, billable, is_private, active, color
  • estimated_hours, rate, fixed_fee, currency (高级功能)

TOGGL_GET_PROJECTS 的关键参数:

  • workspace_id (必需)
  • page / page_size (1-200) 用于分页
  • since / until —— Unix 时间戳用于修改过滤（仅限过去 3 个月）
  • clients: true 以包含完整客户端详情

3. 管理客户端

在工作空间内创建和列出客户端。

工具: TOGGL_CREATE_CLIENT, TOGGL_GET_LIST_CLIENTS

列出工作空间 123456 中的所有活跃客户端，然后创建一个名为 "Acme Corp" 的新客户端
  • TOGGL_CREATE_CLIENT 需要 workspace_id 和 name；接受 notes, external_reference
  • TOGGL_GET_LIST_CLIENTS 需要 workspace_id；支持 status ("active", "archived", "both") 和 name（不区分大小写搜索）

4. 标签和工作空间首选项

检索用于分类的标签并检查工作空间设置。

工具: TOGGL_GET_TAGS, TOGGL_GET_WORKSPACE_PREFERENCES

展示工作空间 123456 中的所有标签和工作空间首选项
  • TOGGL_GET_TAGS 需要 workspace_id；返回标签 ID 和名称
  • TOGGL_GET_WORKSPACE_PREFERENCES 需要 workspace_id；返回定价计划和显示设置

5. 工作空间发现

列出已认证用户所属的所有工作空间。

工具: TOGGL_GET_USER_WORKSPACES

我有权访问哪些 Toggl 工作空间？
  • 不需要参数
  • 返回所有工作空间及 ID、名称和元数据
  • 首先使用此工具来发现其他操作所需的工作空间 ID

6. 用户项目可见性

列出已认证用户可见的项目。

工具: TOGGL_GET_USER_PROJECTS

展示我在所有工作空间中可以看到的所有项目
  • 返回已认证用户有权访问的项目
  • 与 TOGGL_GET_PROJECTS 结合使用以获取工作空间范围内的视图

已知陷阱

  • 标签使用名称，非 ID: TOGGL_CREATE_TIME_ENTRY 在 tags 数组中接受标签名称作为字符串，与许多使用 ID 的 API 不同。使用 TOGGL_GET_TAGS 来验证可用标签名称。
  • created_with 是必需的: 每个时间条目必须包含 created_with（例如，"api_client"）。缺少此字段会导致静默失败。
  • 持续时间以秒为单位: 时间条目上的 duration 参数以秒为单位，而非小时。1 小时 = 3600 秒。
  • since 时间戳限制: TOGGL_GET_PROJECTS 上的 since 过滤器只允许过去 3 个月的时间戳。较旧的查询将被拒绝。
  • 高级功能被锁定: 项目上的自定义颜色、模板、固定费用和小时费率需要高级 Toggl 计划。非高级账户在使用这些字段时会收到错误。
  • 工作空间 ID 无处不在: 几乎所有 Toggl 工具都需要 workspace_id。始终先调用 TOGGL_GET_USER_WORKSPACES 来解析它。

快速参考

工具代号 描述
TOGGL_CREATE_TIME_ENTRY 创建时间条目或运行计时器（需要 workspace_id, created_with, start）
TOGGL_PATCH_STOP_TIME_ENTRY 停止正在运行的时间条目（需要 workspace_id, time_entry_id）
TOGGL_GET_PROJECTS 列出工作空间中的项目，带分页
TOGGL_GET_PROJECT_DETAILS 获取特定项目的详情
TOGGL_CREATE_PROJECT 创建新项目（需要 workspace_id, name）
TOGGL_GET_LIST_CLIENTS 列出带状态/名称过滤器的客户端（需要 workspace_id）
TOGGL_CREATE_CLIENT 创建新客户端（需要 workspace_id, name）
TOGGL_GET_TAGS 列出工作空间中的所有标签（需要 workspace_id）
TOGGL_GET_WORKSPACE_PREFERENCES 获取工作空间设置（需要 workspace_id）
TOGGL_GET_USER_WORKSPACES 列出已认证用户的所有工作空间
TOGGL_GET_USER_PROJECTS 列出已认证用户可见的项目

由 Composio 提供支持