Harvest Automation

Harvest Automation

技能概述

Harvest Automation 让你直接在 Claude Code 中自动化 Harvest 时间跟踪操作，通过自然语言命令记录工时、管理项目和客户、创建任务并获取报告数据。

适用场景

日常工时记录 - 无需打开浏览器，直接在终端快速记录和修改 Harvest 时间条目，支持时长制和时间戳制两种账户类型

项目管理自动化 - 创建新项目、配置计费方式、设置预算、管理客户和任务类型，完整覆盖项目生命周期

工时报告与分析 - 按日期范围、项目、客户等多维度提取时间记录，生成计费汇总和利用率报告

核心功能

时间记录管理 - 创建、查询、更新 Harvest 时间条目，支持按项目、任务、日期筛选，可批量获取未计费记录

项目与客户管理 - 创建带计费配置的新项目（按项目/任务/人员计费），管理客户档案和可复用的任务类型

报告与数据导出 - 通过日期窗口和多维过滤器提取时间记录，支持分页获取完整数据集，用于计费和工时分析

常见问题

如何在 Claude Code 中连接 Harvest 账户？

将 Rube MCP 服务器添加到 Claude Code 配置中，URL 为 https://rube.app/mcp，启动后会收到认证链接，完成 OAuth 授权即可使用。

支持哪些 Harvest 账户类型？

支持两种账户类型：时长制账户使用 hours 参数记录总工时；时间戳制账户使用 started_time 和 ended_time 记录起止时间，技能会自动识别账户类型。

创建时间条目时任务分配有什么限制？

任务的 task_id 必须已分配给指定的 project_id。仅使用 HARVEST_LIST_TASKS 查询全局任务是不够的，需要确认任务已分配到该项目才能成功创建时间条目。