Harvest create time entry

harvest__create_time_entry

Access

Requires a project integration connection for harvest.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
account_idstringYesHarvest Account ID (get it from harvest__list_accounts)
project_idnumberYesHarvest project ID
task_idnumberYesHarvest task ID
spent_datestringYesDate of the time entry (YYYY-MM-DD)
user_idnumberNoUser ID to log time for (defaults to authenticated user)
hoursnumberNoHours to log (e.g. 1.5). Use instead of started_time/ended_time.
started_timestringNoStart time (hh:mmam/pm, e.g. 8:00am). Use with ended_time instead of hours.
ended_timestringNoEnd time (hh:mmam/pm, e.g. 5:30pm). Use with started_time instead of hours.
notesstringNoNotes about the time entry
external_referenceobjectNoExternal reference object with id, group_id, account_id, permalink

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "harvest__create_time_entry",
    "arguments": {
      "account_id": "example",
      "project_id": 0,
      "task_id": 0,
      "spent_date": "example"
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the harvest integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "description": "Harvest Account ID (get it from harvest__list_accounts)"
    },
    "project_id": {
      "type": "number",
      "description": "Harvest project ID"
    },
    "task_id": {
      "type": "number",
      "description": "Harvest task ID"
    },
    "spent_date": {
      "type": "string",
      "description": "Date of the time entry (YYYY-MM-DD)"
    },
    "user_id": {
      "type": "number",
      "description": "User ID to log time for (defaults to authenticated user)"
    },
    "hours": {
      "type": "number",
      "description": "Hours to log (e.g. 1.5). Use instead of started_time/ended_time."
    },
    "started_time": {
      "type": "string",
      "description": "Start time (hh:mmam/pm, e.g. 8:00am). Use with ended_time instead of hours."
    },
    "ended_time": {
      "type": "string",
      "description": "End time (hh:mmam/pm, e.g. 5:30pm). Use with started_time instead of hours."
    },
    "notes": {
      "type": "string",
      "description": "Notes about the time entry"
    },
    "external_reference": {
      "type": "object",
      "description": "External reference object with id, group_id, account_id, permalink"
    }
  },
  "required": [
    "account_id",
    "project_id",
    "task_id",
    "spent_date"
  ],
  "description": "Arguments for the harvest__create_time_entry tool."
}