Harvest

Fetch

Fetch any Harvest resource by ID. Returns complete resource details with metadata. Use colon-routed IDs like 'harvest:time_entry:123' to specify resource type. Supports users, projects, clients, tasks, and time_entries.

Harvest Create Time Entry

Create a new time entry in Harvest. Time entries record hours worked on specific tasks for projects. Can create completed time entries with specific hours, or start a running timer by omitting hours. Returns the created time entry with ID, calculated totals, and billable status. Use this to log past work or start tracking current work.

Harvest Get Current User

Get information about the currently authenticated Harvest user. Returns detailed user information including ID, name, email, role, permissions, timezone, and whether the user is an admin or project manager. Use this to understand the context of who is making requests, get your user ID for filtering, or check your permissions.

Harvest List Clients

List all clients in Harvest account. Clients are organizations or individuals you track time and expenses for. Returns client details including name, address, currency, and status. Use filters to find active/inactive clients.

Harvest List Contacts

List all client contacts in Harvest account. Contacts are individuals associated with clients. Returns contact details including name, email, phone numbers, and associated client. Use filters to find contacts by client.

Harvest List Expenses

List all expenses in Harvest account. Expenses are costs tracked against projects. Returns expense details including amount, category, project, client, user, receipt, and billing status. Use filters to find expenses by user, project, client, date range, or billing status.

Harvest List Project Assignments

List project assignments in Harvest. Project assignments define which users can track time on which projects. Each assignment includes the project, user, task assignments (which tasks are available), hourly rate, and budget information. Use this to discover which projects you can track time on, or to see all users assigned to a specific project. Essential for determining valid project_id values when creating time entries.

Harvest List Projects

List all projects in Harvest account. Projects are containers for time tracking and organize work by client. Returns project details including name, client, budget, billing method, and status. Use filters to find projects by client or active status.

Harvest List Task Assignments

List task assignments in Harvest. Task assignments define which tasks are available for which projects. Each assignment includes the task details, whether it's billable, hourly rate, and budget information. Use this to discover which tasks you can track time on for a specific project. Essential for determining valid task_id values when creating time entries - you must use a task that's assigned to your chosen project.

Harvest List Tasks

List all tasks in Harvest account. Tasks are types of work that can be tracked against projects (e.g., Design, Development, Meeting, Research). Returns task details including name, billable status, default hourly rate, and status. Tasks are assigned to projects and used when creating time entries.

Harvest List Time Entries

List time entries from Harvest account. Time entries are records of time spent on tasks for projects. Returns entry details including project, task, user, hours, notes, billable status, and dates. Use extensive filters to find specific entries by user, project, client, task, date range, running status, or billing status. Essential for time tracking analysis and reporting.

Harvest List Users

List all users in Harvest account. Users are team members who can track time, submit expenses, and access the account. Returns user details including name, email, roles, and status. Use filters to find active/inactive users.

Harvest Restart Timer

Restart a stopped timer in Harvest. Continues tracking time on an existing time entry that was previously stopped. The timer must not be currently running. Returns the time entry with is_running=true and a new timer_started_at timestamp. Use this to resume work on a task after a break without creating a new time entry.

Harvest Start Timer

Start a new running timer in Harvest for real-time time tracking. Creates a time entry for today's date with no hours set, which tracks elapsed time automatically. The timer runs until you stop it. Only one timer can run at a time per user - starting a new timer automatically stops any currently running timer. Returns the time entry with is_running=true and timer_started_at timestamp.

Harvest Stop Timer

Stop a currently running timer in Harvest. Calculates the total hours worked based on elapsed time since the timer was started and saves the time entry with is_running=false. Returns the updated time entry with calculated hours. List time entries with filter is_running=true to find active timers, or use the time_entry_id returned when starting a timer.

Harvest Update Time Entry

Update an existing time entry in Harvest. Modify any aspect of a time entry including project, task, hours, notes, dates, or running status. Only provide the fields you want to change - all fields are optional except time_entry_id. Returns the updated time entry with all current values. Use this to correct mistakes, add details, or move time entries between projects.

Harvest Upsert Client

Create a new client or update an existing client in Harvest. Clients are organizations or individuals you track time and expenses for. For create: provide name (required) and other fields. For update: provide client_id and only the fields you want to change. Returns client object with ID. Use is_active=false to archive a client.

Harvest Upsert Contact

Create a new client contact or update an existing contact in Harvest. Contacts are individuals associated with clients. For create: provide client_id and first_name (required) and other fields. For update: provide contact_id and only the fields you want to change. Returns contact object with ID.

Harvest Upsert Expense

Create a new expense or update an existing expense in Harvest. Expenses are costs tracked against projects. For create: provide project_id, expense_category_id, and spent_date (required) and other fields. For update: provide expense_id and only the fields you want to change. Returns expense object with ID.

Harvest Upsert Project

Create a new project or update an existing project in Harvest. Projects are containers for time tracking and organize work by client. For create: provide client_id and name (required) and other fields. For update: provide project_id and only the fields you want to change. Returns project object with ID. Use is_active=false to archive a project.

Harvest Upsert Project Assignment

Create a new project user assignment or update an existing assignment in Harvest. Project assignments define which users can track time on which projects. For create: provide project_id and user_id (required) and other fields. For update: provide assignment_id and only the fields you want to change. Returns assignment object with ID.

Harvest Upsert Task

Create a new task or update an existing task in Harvest. Tasks are used to categorize time entries within projects. For create: provide name (required) and other fields. For update: provide task_id and only the fields you want to change. Returns task object with ID. Use is_active=false to archive a task.

Harvest Upsert Task Assignment

Create a new project task assignment or update an existing assignment in Harvest. Task assignments define which tasks are available on which projects. For create: provide project_id and task_id (required) and other fields. For update: provide assignment_id and only the fields you want to change. Returns assignment object with ID.

Harvest Upsert User

Create a new user or update an existing user in Harvest. Users are team members who can track time, submit expenses, and access the account. For create: provide first_name, last_name, and email (required) and other fields. For update: provide user_id and only the fields you want to change. Returns user object with ID. Use is_active=false to archive a user.