create_time_log

Creates a time-tracking entry. Requires startTime (ISO 8601), or notes with an explicit duration like '2 hours', '1h30m' or '45 minutes'. When startTime is omi…

Use with an AI agent

Export this page as Markdown or bundle it with a task for your agent.

Try a task
Preview the prompt that will be copied

Access

  • Effect: Creates data
  • Required scope: write (the mcp scope also grants it)

Example request

The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_time_log",
    "arguments": {}
  }
}

Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.

Description

Creates a time-tracking entry. Requires startTime (ISO 8601), or notes with an explicit duration like '2 hours', '1h30m' or '45 minutes'. When startTime is omitted and notes contain a duration, the entry starts at 09:00 on the day the notes name (yesterday, else today) in timeZone (UTC if unset) and lasts that duration. MCP never invents a duration. Notes starting with log/record/track/add/enter are shortened to the activity; other notes are kept verbatim. userId is set automatically.

Input parameters

NameTypeRequiredDescription
addressIdstringNo
billablebooleanNo
currencystringNo
endTimestringNo
hourlyRatenumberNo
latitudenumberNo
longitudenumberNo
notesstringNo
startTimestringNo
statusstringNo
taskIdstringNo
timeZonestringNo
Full input schema (JSON Schema)
json
{
  "additionalProperties": false,
  "properties": {
    "addressId": {
      "type": "string"
    },
    "billable": {
      "type": [
        "null",
        "boolean"
      ]
    },
    "currency": {
      "type": "string"
    },
    "endTime": {
      "type": [
        "null",
        "string"
      ]
    },
    "hourlyRate": {
      "type": [
        "null",
        "number"
      ]
    },
    "latitude": {
      "type": [
        "null",
        "number"
      ]
    },
    "longitude": {
      "type": [
        "null",
        "number"
      ]
    },
    "notes": {
      "type": "string"
    },
    "startTime": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "taskId": {
      "type": "string"
    },
    "timeZone": {
      "type": "string"
    }
  },
  "type": "object"
}