# Harvest

> Harvest is an online time-tracking tool.

Harvest tracks time entries and project budgets, but understanding which clients are most profitable or how billable utilization affects cash flow requires connecting to your invoicing and accounting tools.

Filament links your Harvest data to platforms like Xero and your CRM, turning questions about project profitability, resource allocation, and revenue forecasting into instant business intelligence.

## Data we sync

- **Time Entries**: Track billable and non-billable hours with user_id, project_id, task_id, hours, billable_rate, and notes for detailed utilization analysis. (`user_id`, `project_id`, `task_id`, `hours`, `billable_rate`, `is_billable`, `spent_date`)
- **Projects**: Analyze project performance with budget, budget_by, is_billable, bill_by, hourly_rate, cost_budget, and fee for profitability tracking. (`client_id`, `budget`, `budget_by`, `is_billable`, `bill_by`, `hourly_rate`, `cost_budget`)
- **Clients**: Track client relationships with name, currency, address, and is_active to analyze revenue concentration and client profitability patterns. (`name`, `currency`, `is_active`, `address`)
- **Invoices**: Monitor cash flow with amount, due_amount, tax, tax2, discount, state, issue_date, due_date, and payment_term for revenue forecasting. (`client_id`, `amount`, `due_amount`, `state`, `issue_date`, `due_date`, `paid_date`)
- **Tasks**: Understand work breakdown with name, billable_by_default, default_hourly_rate, and is_active to see which task types drive revenue. (`name`, `billable_by_default`, `default_hourly_rate`, `is_active`)
- **User Assignments**: Track resource allocation with user_id, project_id, is_project_manager, hourly_rate, and budget to optimize team utilization across projects. (`user_id`, `project_id`, `is_project_manager`, `hourly_rate`, `budget`)
- **Expenses**: Analyze project costs with project_id, expense_category_id, total_cost, units, receipt, and notes to calculate true project margins. (`project_id`, `expense_category_id`, `total_cost`, `units`, `is_billable`, `spent_date`)
- **Estimates**: Compare quoted work to actuals with amount, tax, tax2, discount, state, issue_date, and accepted_at for proposal accuracy analysis. (`client_id`, `amount`, `state`, `issue_date`, `accepted_at`)

## How do I connect Harvest?

You need an active Harvest account that can create personal access tokens. Filament manages the destination for you.

1. Sign in at [Harvest ID](https://id.getharvest.com/) and open **Developers**.
2. Under **Personal access tokens**, select **Create new personal access token**. Name it, create it and copy the token.
3. Open [Apps](https://filamentanalytics.com/apps) in Filament and add **Harvest**.
4. Paste the token, select **Save & Test**, then return to Filament and complete setup.
