Harvest

Tool to create a new client. use after gathering client details to register a new client in harvest.

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.

Tool to create a new estimate. use after gathering client and line item details.

Tool to create a new estimate item category in harvest. use after deciding to categorize line items within an estimate.

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.

Tool to create a new expense entry. use when recording costs against projects. ensure either units or total cost is provided.

Tool to create a new invoice. use when you have gathered all invoice details and need to bill a client in harvest.

Tool to create a new invoice item category. use after you have decided on the category name to register it in harvest.

Tool to create a new message for an invoice. use after confirming the invoice id when you need to notify a client with invoice details.

Tool to create a new payment on an invoice. use when recording a payment against an existing invoice.

Tool to create a new project. use after confirming the client exists.

Tool to create a new task. use after identifying task details to register it in harvest.

Tool to create a new time entry. use when logging hours for a project by specifying start/end times or duration.

Tool to create a new user. use after gathering user details to invite them to harvest.

Tool to delete a client. use when you need to remove a client that has no associated projects, invoices, or estimates. call after confirming the client id exists and has no dependent resources.

Tool to delete a client contact. use when you need to remove a contact that is no longer relevant. call after confirming the contact id exists.

Tool to delete an estimate. use when you need to remove an estimate that is no longer needed. call after confirming the estimate id exists and has no dependent resources.

Tool to delete an estimate message. use when you need to remove a message from an estimate. call after confirming estimate id and message id are correct.

Tool to delete an invoice. use when you need to remove an invoice that has no associated payments. call after confirming the invoice id exists.

Tool to delete an invoice item category. use when you need to remove an obsolete or incorrect invoice item category. call after confirming the invoice item category id exists.

Tool to delete a message from an invoice. use when you need to remove a specific message that is no longer relevant. call after confirming the invoice id and message id.

Tool to delete an invoice payment. use when you need to remove a payment from an invoice after confirming payment details.

Tool to delete a project. use when you need to remove a project and all its associated time entries and expenses; invoices remain intact. call after confirming the project id exists.

Tool to delete a task. use when you need to remove a task that has no associated time entries. call after confirming the task id exists and has no dependent time entries.

Tool to delete a time entry. use when removing an existing time entry that is deletable (not closed or on archived projects/tasks). call after confirming the time entry id exists.

Tool to delete a user. use when you need to remove a user that has no associated time entries or expenses. call after confirming the user id exists and has no dependent time entries or expenses.

Tool to retrieve a specific client by id. use when you need details of a client before invoicing or reporting.

Tool to retrieve a specific client contact. use when you have client id and contact id to fetch and verify contact details.

Tool to retrieve information about the authenticated user's company. use after authentication to fetch company settings for display or configuration.

Tool to retrieve a specific estimate by id. use after confirming the estimate id. example: "get estimate with id 123456".

Tool to retrieve a specific invoice by id. use when you need the full details of an invoice after selecting or creating it. example: 'get invoice with id 13150378.'

Tool to retrieve a specific harvest project by id. use when you have a project id and need its details.

Tool to retrieve a specific task by id. use when you have a task id and need its detailed information.

Tool to retrieve a single time entry by id. use when you have a specific time entry id and need its full details.

Tool to retrieve a specific user by id. use after obtaining a valid user id (for example via list users). example: "get details of user 3230547".

Tool to list clients. use when you need to retrieve a paginated list of clients from harvest. ensure you have a valid access token in metadata before calling.

Tool to list client contacts. use when you need to retrieve contacts with optional filtering and pagination.

Tool to list messages for an estimate. use after obtaining an estimate id to retrieve associated messages, supports pagination and filtering by update time.

Tool to list expense categories. use when you need to retrieve a paginated list of expense categories, optionally filtering by active status or last update timestamp.

Tool to list invoices. use when you need to retrieve invoices filtered by client, project, date range, or state. example: 'list invoices for client 5735776 from 2023-01-01 to 2023-01-31.'

Tool to retrieve invoice item categories. use when you need to fetch a paginated list of invoice item categories in harvest.

Tool to list messages associated with a given invoice. use when you need to retrieve invoice messages with optional filtering by update time and pagination.

Tool to retrieve payments for a specific invoice. use when you need to list all payments applied to an invoice after confirming the invoice exists.

Tool to list projects. use when you need to retrieve a paginated list of projects from harvest. ensure a valid access token is present in metadata before calling.

Tool to list tasks. use when you need to retrieve a paginated list of tasks from harvest. ensure you have a valid access token in metadata before calling.

Tool to retrieve a list of time entries. use when you need to fetch tracked hours with filters or date ranges for reporting or invoicing. example: "list time entries for project 123 between 2023-01-01 and 2023-01-31".

Tool to list users. use when you need to retrieve a paginated list of users from harvest.

Tool to update an existing client. use after retrieving client details to modify its properties. supports partial updates; omit fields to leave them unchanged.

Tool to update a client contact. use when you have a contact id and need to modify its details.

Tool to update information about the company. use to modify company settings such as name, timezone, or formatting options. use after obtaining current settings to apply changes.

Tool to update an existing estimate. use when you need to modify specific fields of an estimate; omit parameters to leave other fields unchanged.

Tool to update an estimate item category. use after retrieving the category to change its name.

Tool to update an existing expense. use after retrieving an expense to modify project, category, date, cost, or delete a receipt; omit fields to leave unchanged.

Tool to update an existing invoice. use after retrieving invoice details to modify its fields. supports partial updates; omit fields to leave unchanged.

Tool to update an existing project. use when you need to modify one or more fields of a project by its id. invoke after confirming the project id and desired changes.

Tool to update an existing task. use after retrieving task details to modify its attributes such as name, billing defaults, or status. supports partial updates; omit fields to leave them unchanged.

Tool to update an existing time entry. use after retrieving the entry to adjust hours, notes, project, or task details. supports partial updates; omit fields to leave unchanged.

Tool to update an existing user. use when you need to modify a user's profile or settings after confirming the user id.