# Harvest AI integration on Definable

> Harvest is a time-tracking and invoicing tool designed for teams and freelancers, helping them log billable hours, manage projects, and streamline payments

## What this connects

Harvest is a time-tracking and invoicing tool designed for teams and freelancers, helping them log billable hours, manage projects, and streamline payments

Vendor: https://www.getharvest.com/

## Tools available

**57** tools available. First 12:

- `HARVEST_CREATE_CLIENT` — Create Client — Tool to create a new client. Use after gathering client details to register a new client in Harvest.
- `HARVEST_CREATE_CLIENT_CONTACT` — Create Client Contact — Tool to create a new client contact. Use when you need to add a contact under an existing client. Call after you've retrieved or confirmed the client_id.
- `HARVEST_CREATE_ESTIMATE` — Create Estimate — Tool to create a new estimate. Use after gathering client and line item details.
- `HARVEST_CREATE_ESTIMATE_ITEM_CATEGORY` — Create Estimate Item Category — Tool to create a new estimate item category in Harvest. Use after deciding to categorize line items within an estimate.
- `HARVEST_CREATE_ESTIMATE_MESSAGE` — Create Estimate Message — Tool to create a new message for an estimate. Use when you have an estimate ID and want to send a message or run an event (send, accept, decline, re-open) on the estimate.
- `HARVEST_CREATE_EXPENSE` — Create Expense — Tool to create a new expense entry. Use when recording costs against projects. Ensure either units or total_cost is provided.
- `HARVEST_CREATE_INVOICE` — Create Invoice — Tool to create a new invoice. Use when you have gathered all invoice details and need to bill a client in Harvest.
- `HARVEST_CREATE_INVOICE_ITEM_CATEGORY` — Create Invoice Item Category — Tool to create a new invoice item category. Use after you have decided on the category name to register it in Harvest.
- `HARVEST_CREATE_INVOICE_MESSAGE` — Create Invoice Message — Creates a new message for an invoice in Harvest. Use this to send invoice notifications to clients, create draft messages, or change invoice states (close/reopen). Requires a valid invoice ID. The invoice must be in the appropriate state for the requested event_type.
- `HARVEST_CREATE_INVOICE_PAYMENT` — Create Invoice Payment — Tool to create a new payment on an invoice. Use when recording a payment against an existing invoice.
- `HARVEST_CREATE_PROJECT` — Create Project — Create a new project in Harvest. A project is a container for tracking time, expenses, and invoices for a specific client engagement. Required: You must provide a valid client_id (use list_clients or create_client first), project name, and billing configuration (is_billable, bill_by, budget_by). Common use cases: - Time & Materials: is_billable=true, bill_by="Tasks", budget_by="project" - Fixed Fee: is_billable=true, bill_by="Project", budget_by="none", is_fixed_fee=true - Internal/Non-billable: is_billable=false, bill_by="none", budget_by="none"
- `HARVEST_CREATE_TASK` — Create Task — Creates a new task in Harvest. Tasks are reusable activity types (e.g., "Development", "Design", "Consulting") that can be assigned to projects for time tracking. Use this to define billable or non-billable work categories that your team will track time against.

## Auth

Auth schemes: `OAUTH2`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Harvest

Inside a Definable workflow, Harvest is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Harvest** — the Researcher (GPT-5.5) pulls context from Harvest (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Harvest** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Harvest (create record, post message, draft email).
- **Designer / Engineer → Distributor → Harvest** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Harvest (attach file, open PR comment, post status).

The Verifier checks every Harvest call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- time tracking software — https://definable.ai/apps/category/time-tracking-software/
- proposal & invoice management — https://definable.ai/apps/category/proposal-&-invoice-management/

## Related

- HTML page: https://definable.ai/apps/harvest/
- Same category (time tracking software): https://definable.ai/apps/category/time-tracking-software/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt