{/* 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.
Setup
- 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.
- Create an OAuth2 application: In Harvest ID, open Developers and create an OAuth2 application.
- 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.
- 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.
Tools
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.