Harvest

Harvest

Time tracking and invoicing software for teams and businesses. Track billable hours, manage projects, analyze profitability, and generate invoices.

Data Model

• Account is identified by account_id, which the platform reads from the configured credential's scope (harvest:{account_id}) when present.
• Clients own projects. Create client first, then projects.
• Projects belong to clients. Assign users and tasks to projects.
• Tasks are project-level work types. Assign tasks to projects via task assignments.
• Time Entries record hours against project+task. Create, update, start/stop timer.
• Expenses are project-level costs with expense_category_id.
• Contacts belong to clients. Users are team members with project/task assignments.

Gotchas

• account_id: Must be available for every request—either from token scope (harvest:{account_id}) or set explicitly on the connection.
• Configurable defaults: project_id, task_id, client_id can be set as defaults to avoid passing every request.
• Rate limit: Tight burst window with a higher sustained allowance overall—back off with exponential delays when responses signal throttling.
• Timer state: Only one running timer per user. Stop before starting another.