Harvest

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Enabled by default.
  • Authentication: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider's consent screen.

Credentials

Set these per environment. See Connect an integration.

These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

VariableRequiredDescription
HARVEST_CLIENT_IDYesHarvest OAuth2 Client ID (from your OAuth2 application in Harvest ID) Docs.
HARVEST_CLIENT_SECRETYesHarvest OAuth2 Client Secret Docs.

Setup

  1. Choose who owns the Harvest OAuth app: On hosted Veryfront, Harvest uses the Veryfront-managed Harvest OAuth app: connect Harvest from the project's integrations and approve the Harvest consent screen, no environment variables needed. Set HARVEST_CLIENT_ID and HARVEST_CLIENT_SECRET only to use your own Harvest OAuth app, which is required for local and self-hosted runs.
  2. Create an OAuth2 application: In Harvest ID, open Developers and create an OAuth2 application.
  3. Set the redirect URL: Add the redirect URI of the environment that completes the flow: https://api.veryfront.com/oauth/callback/harvest for hosted Veryfront, or your app origin followed by /api/auth/harvest/callback for a local or self-hosted app. Set HARVEST_CLIENT_ID and HARVEST_CLIENT_SECRET from the app's credentials.
  4. Verify access: Run List Accounts (read-only). It returns the Harvest accounts the connected user can reach, with the account ID the other tools take, without changing anything.

Provider notes

  • Harvest has no per-endpoint scopes: during consent the user chooses which Harvest accounts the connection can reach.
  • The time-entry and user tools take the account_id from List Accounts, which Harvest requires on every request.
  • Tools that create, update, send or delete data are marked as writes and need write authority; the other tools are read-only.

Provider API reference.

Tools

ToolAccessDescription
List Accounts<br /><code className="reference-identifier">harvest__list_accounts</code>ReadList accounts
Get Current User<br /><code className="reference-identifier">harvest__get_current_user</code>ReadGet current user
List Users<br /><code className="reference-identifier">harvest__list_users</code>ReadList users
List Time Entries<br /><code className="reference-identifier">harvest__list_time_entries</code>ReadList time entries
Get Time Entry<br /><code className="reference-identifier">harvest__get_time_entry</code>ReadGet time entry
Create Time Entry<br /><code className="reference-identifier">harvest__create_time_entry</code>WriteCreate time entry
Update Time Entry<br /><code className="reference-identifier">harvest__update_time_entry</code>WriteUpdate time entry
Delete Time Entry<br /><code className="reference-identifier">harvest__delete_time_entry</code>WriteDelete unlocked, unbilled time entry
Stop Timer<br /><code className="reference-identifier">harvest__stop_timer</code>WriteStop timer
Restart Timer<br /><code className="reference-identifier">harvest__restart_timer</code>WriteRestart timer
List Projects<br /><code className="reference-identifier">harvest__list_projects</code>ReadList projects
Get Project<br /><code className="reference-identifier">harvest__get_project</code>ReadGet project
List Tasks<br /><code className="reference-identifier">harvest__list_tasks</code>ReadList tasks
List Project Task Assignments<br /><code className="reference-identifier">harvest__list_project_task_assignments</code>ReadList project task assignments
List Clients<br /><code className="reference-identifier">harvest__list_clients</code>ReadList clients
Get Client<br /><code className="reference-identifier">harvest__get_client</code>ReadGet client
List Invoices<br /><code className="reference-identifier">harvest__list_invoices</code>ReadList invoices
Get Invoice<br /><code className="reference-identifier">harvest__get_invoice</code>ReadGet invoice
Create Invoice<br /><code className="reference-identifier">harvest__create_invoice</code>WriteCreate invoice
Update Invoice<br /><code className="reference-identifier">harvest__update_invoice</code>WriteUpdate invoice
List Invoice Payments<br /><code className="reference-identifier">harvest__list_invoice_payments</code>ReadList invoice payments
Create Invoice Payment<br /><code className="reference-identifier">harvest__create_invoice_payment</code>WriteRecord invoice payment
Time Report by Project<br /><code className="reference-identifier">harvest__time_report_by_project</code>ReadGet time report by project
Time Report by Team<br /><code className="reference-identifier">harvest__time_report_by_team</code>ReadGet time report by team
Time Report by Client<br /><code className="reference-identifier">harvest__time_report_by_client</code>ReadGet time report by client
Time Report by Task<br /><code className="reference-identifier">harvest__time_report_by_task</code>ReadGet time report by task
Invoice Report<br /><code className="reference-identifier">harvest__invoice_report</code>ReadGet invoice report

Verify the connection

Call a read tool such as harvest__list_accounts with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.