Harvest MCP by usefulapi

usefulapi 的 Harvest MCP

在 Claude、Cursor 或任何 MCP 客户端中使用你的 Harvest 账户——读取时间条目、项目、客户、任务和发票，并记录或更新已追踪的时间。托管服务， 无需本地安装：使用你自己的凭据连接。

实时端点： https://harvest.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、桌面版）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://harvest.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http harvest https://harvest.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "harvest": {
      "url": "https://harvest.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Harvest 凭据。

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/harvest/

首次连接时，你需要提供 Harvest 个人访问令牌和账户 ID（id.getharvest.com → Developers）。系统会验证令牌、按用户存储，并将其限定为仅供你使用——配置文件中不会存放密钥。

工具

工具	类型	功能
harvest_list_time_entries	read	列出时间条目
harvest_get_time_entry	read	获取时间条目
harvest_list_projects	read	列出项目
harvest_get_project	read	获取项目
harvest_list_clients	read	列出客户
harvest_get_client	read	获取客户
harvest_list_tasks	read	列出任务
harvest_list_users	read	列出用户
harvest_get_current_user	read	获取当前用户
harvest_list_project_assignments	read	列出我的项目分配
harvest_list_invoices	read	列出发票
harvest_get_invoice	read	获取发票
harvest_list_estimates	read	列出估价单
harvest_list_expenses	read	列出费用
harvest_get_company	read	获取公司信息
harvest_create_time_entry	write	创建时间条目
harvest_update_time_entry	write	更新时间条目
harvest_stop_time_entry	write	停止正在运行的时间条目
harvest_restart_time_entry	write	重启已停止的时间条目
harvest_delete_time_entry	write	删除时间条目
harvest_usage_status	meta	使用情况（免费套餐用量计数）
harvest_request_feature	meta	请求添加缺失功能
harvest_upgrade	meta	升级到 Pro（无限制*）
harvest_cancel_subscription	meta	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先确认）；meta 工具用于报告用量、管理订阅或发送功能请求。

定价

套餐	价格	限额
免费版	$0	每月 50 次工具调用
Pro	$9/月 或 $90/年（免费 2 个月）	无限制*

*此服务上的 Pro 套餐设有合理使用限额：每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 套餐仅适用于此服务。使用 harvest_upgrade 订阅（它会返回 Stripe Checkout 链接）。你可以随时使用 harvest_cancel_subscription 取消：Pro 权益会持续到已付费周期结束；当前周期不予退款，并且在此之前运行 harvest_upgrade 会撤销取消。也可以发送邮件至 [email protected]。

许可证

MIT——参见 LICENSE。仅提供文档；服务由托管平台提供。