名称: Harvest 自动化描述: “在 Harvest 中自动化时间跟踪、项目管理和发票工作流程——通过自然语言命令记录工时、管理项目、客户和任务。” 要求: mcp: - rube

Harvest 自动化

直接从 Claude Code 自动化您的 Harvest 时间跟踪操作。记录时间条目、管理项目和客户、创建任务并提取报告数据——所有这些都无需离开终端。

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

设置

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

核心工作流程

1. 记录和管理时间条目

创建、列出、更新和检索时间条目，以确保准确的计费和报告。

工具: HARVEST_CREATE_TIME_ENTRY, HARVEST_LIST_TIME_ENTRIES, HARVEST_GET_TIME_ENTRY, HARVEST_UPDATE_TIME_ENTRY

为项目 12345、任务 67890 记录今天 3.5 小时的开发工作

HARVEST_CREATE_TIME_ENTRY 的关键参数:

project_id (必需) —— 记录工时的项目
task_id (必需) —— 必须分配给该项目的任务
spent_date (必需) —— 日期，格式为 YYYY-MM-DD
hours —— 总小时数（用于基于时长的账户）
started_time / ended_time —— 用于基于时间戳的账户
notes —— 工作描述

HARVEST_LIST_TIME_ENTRIES 的关键参数:

from_date / to —— 日期范围过滤器（YYYY-MM-DD）
project_id, client_id, task_id, user_id —— 实体过滤器
is_billed / is_running —— 状态过滤器
page / per_page (最多 2000) —— 分页

2. 管理项目

创建新项目并列出现有项目，包括客户和计费配置。

工具: HARVEST_CREATE_PROJECT, HARVEST_LIST_PROJECTS, HARVEST_GET_PROJECT

为客户 456 创建一个名为“网站重新设计”的可计费项目，使用任务计费和项目预算

HARVEST_CREATE_PROJECT 的关键参数:

name, client_id, is_billable, bill_by, budget_by (全部必需)
bill_by 选项: "Project", "Tasks", "People", "none"
budget_by 选项: "project", "project_cost", "task", "task_fees", "person", "none"
可选: budget, hourly_rate, starts_on, ends_on, is_fixed_fee

3. 管理客户

创建和列出项目所属的客户。

工具: HARVEST_CREATE_CLIENT, HARVEST_LIST_CLIENTS

列出我们 Harvest 账户中的所有活跃客户

HARVEST_CREATE_CLIENT 需要 name；接受 address, currency, is_active
HARVEST_LIST_CLIENTS 支持 is_active 过滤器和分页（per_page 最多 2000）

4. 管理任务

创建和列出用于时间跟踪的可重用任务类型。

工具: HARVEST_CREATE_TASK, HARVEST_LIST_TASKS

创建一个名为“代码审查”的新可计费任务，默认费率为每小时 150 美元

HARVEST_CREATE_TASK 需要 name；接受 billable_by_default, default_hourly_rate, is_active, is_default
HARVEST_LIST_TASKS 支持 is_active, is_default 过滤器和分页（per_page 最多 100）
任务名称必须在所有任务（活跃和归档）中唯一

5. 时间条目报告

提取具有日期范围和过滤器的时间条目，用于计费摘要和利用率报告。

工具: HARVEST_LIST_TIME_ENTRIES, HARVEST_GET_TIME_ENTRY

显示项目 789 从 2026 年 1 月开始的所有未计费时间条目

使用 from_date 和 to 进行日期窗口设置
使用 is_billed: false 过滤未计费条目
结合 project_id, user_id, client_id 进行跨维度报告
使用 page 和 per_page 分页以收集完整数据集

6. 更新和更正时间条目

修改现有时间条目以修正工时、重新分配项目或更新备注。

工具: HARVEST_UPDATE_TIME_ENTRY

更新时间条目 123456，将工时更改为 4.0，并添加备注“完成 API 集成”

需要 time_entry_id
支持部分更新——只包含您要更改的字段
可以更新 hours, notes, project_id, task_id, spent_date, started_time, ended_time

已知陷阱

任务分配很重要: 创建时间条目时，task_id 必须对应实际分配给指定 project_id 的任务。使用项目任务分配端点验证，而不仅仅是 HARVEST_LIST_TASKS（它返回全局任务）。
时长与时间戳跟踪: Harvest 账户配置为基于时长或基于时间戳的跟踪。在时间戳账户上忽略 hours；在时长账户上忽略 started_time/ended_time。
分页限制各异: HARVEST_LIST_TIME_ENTRIES 和 HARVEST_LIST_CLIENTS 支持每页最多 2000 条，但 HARVEST_LIST_PROJECTS 和 HARVEST_LIST_TASKS 每页限制为 100 条。
日期格式一致性: 所有日期参数必须使用 YYYY-MM-DD 格式。ISO 8601 带时区用于 updated_since 过滤器。
项目必需字段: HARVEST_CREATE_PROJECT 需要五个字段: name, client_id, is_billable, bill_by, 和 budget_by。缺少任何字段都会导致验证错误。

快速参考

工具标识	描述
`HARVEST_LIST_TIME_ENTRIES`	列出具有日期、项目、客户、用户过滤器的时间条目
`HARVEST_CREATE_TIME_ENTRY`	记录新时间条目（需要 `project_id`, `task_id`, `spent_date`）
`HARVEST_GET_TIME_ENTRY`	按 ID 检索特定时间条目
`HARVEST_UPDATE_TIME_ENTRY`	更新现有时间条目（需要 `time_entry_id`）
`HARVEST_LIST_PROJECTS`	列出项目，带可选客户过滤器
`HARVEST_CREATE_PROJECT`	创建具有计费配置的新项目
`HARVEST_GET_PROJECT`	按 ID 检索特定项目
`HARVEST_LIST_CLIENTS`	列出客户，带活跃/非活跃过滤器
`HARVEST_CREATE_CLIENT`	创建新客户（需要 `name`）
`HARVEST_LIST_TASKS`	列出可重用任务类型
`HARVEST_CREATE_TASK`	创建新任务类型（需要 `name`）

由 Composio 提供支持

名称: Harvest 自动化 描述: “在 Harvest 中自动化时间跟踪、项目管理和发票工作流程——通过自然语言命令记录工时、管理项目、客户和任务。” 要求: mcp: - rube