Skip to content
MCP server

Harvest MCP by usefulapi

Read time entries, projects, clients, tasks and invoices; log and update tracked time.

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Harvest MCP by usefulapi

Harvest MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http harvest https://harvest.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://harvest.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "harvest": {
      "url": "https://harvest.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "harvest": {
      "type": "http",
      "url": "https://harvest.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "harvest": {
      "serverUrl": "https://harvest.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "harvest": {
      "type": "http",
      "url": "https://harvest.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (20)

Read directly from the server.

harvest_list_time_entries
List time entries, optionally filtered by user, project, client, task, date range, running/billed status, or updated-since. Paginated. Harvest REST: GET /time_entries.
harvest_get_time_entry
Retrieve a single time entry by id. Harvest REST: GET /time_entries/{id}.
harvest_list_projects
List projects, optionally filtered by active status or client, or updated-since. Paginated. Harvest REST: GET /projects.
harvest_get_project
Retrieve a single project by id. Harvest REST: GET /projects/{id}.
harvest_list_clients
List clients, optionally filtered by active status or updated-since. Paginated. Harvest REST: GET /clients.
harvest_get_client
Retrieve a single client by id. Harvest REST: GET /clients/{id}.
harvest_list_tasks
List tasks (the billable/non-billable work categories that can be assigned to projects), optionally filtered by active status or updated-since. Paginated. Harvest REST: GET /tasks.
harvest_list_users
List users in the account, optionally filtered by active status or updated-since. Paginated. Harvest REST: GET /users.
harvest_get_current_user
Retrieve the currently authenticated user (whom the access token belongs to). Harvest REST: GET /users/me.
harvest_list_project_assignments
List the authenticated user's active project assignments — the projects and their assignable tasks the current user can log time against (use this to find the project_id + task_id for harvest_create_time_entry). Paginated. Harvest REST: GET /users/me/project_assignments.
harvest_list_invoices
List invoices, optionally filtered by client, project, state, date range, or updated-since. Paginated. Harvest REST: GET /invoices.
harvest_get_invoice
Retrieve a single invoice by id, including its line items. Harvest REST: GET /invoices/{id}.
harvest_list_estimates
List estimates, optionally filtered by client, state, date range, or updated-since. Paginated. Harvest REST: GET /estimates.
harvest_list_expenses
List expenses, optionally filtered by user, client, project, date range, billed status, or updated-since. Paginated. Harvest REST: GET /expenses.
harvest_get_company
Retrieve the company/account settings for the authenticated account (name, currency, time/date formats, week start, feature flags). Harvest REST: GET /company.
harvest_create_time_entry
Create a time entry. Requires project_id, task_id and spent_date. Provide `hours` to log a specific duration; OR provide `started_time` (+ optional `ended_time`) for a timestamped entry; OR omit both to start a running timer (on a timestamp-tracking account). Use harvest_list_project_assignments to find valid project_id + task_id. Harvest REST: POST /time_entries. WRITE — creates data.
harvest_update_time_entry
Update an existing time entry's hours, notes, spent date, or project/task. Only the fields you provide are changed. Harvest REST: PATCH /time_entries/{id}. WRITE — modifies data.
harvest_stop_time_entry
Stop a currently running time entry (no-op error if it is already stopped). Harvest REST: PATCH /time_entries/{id}/stop. WRITE — modifies data.
harvest_restart_time_entry
Restart a previously stopped time entry, resuming its timer (error if it is already running). Harvest REST: PATCH /time_entries/{id}/restart. WRITE — modifies data.
harvest_delete_time_entry
Permanently delete a time entry by id. This cannot be undone. Harvest REST: DELETE /time_entries/{id}. WRITE — destroys data.

Harvest MCP by usefulapi FAQ

How do I add Harvest MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http harvest https://harvest.usefulapi.io/mcp