set_person_time_zone

All MCP toolsWrite

Save the person's IANA time zone, or pass null to clear it back to device inference. An invalid IANA name refuses with zero writes. The time zone is the person's own display setting for date-times (interview slots, availability): an IANA name such as "Asia/Tokyo". null means unset — the person's device infers it. A setting, not profile data: reading or writing it never changes the profile version.

Input schema

{
  "type": "object",
  "properties": {
    "personId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The person whose time zone to set (persons.id — self)."
    },
    "timeZone": {
      "anyOf": [
        {
          "type": "string",
          "description": "An IANA time-zone name, e.g. \"Asia/Tokyo\"."
        },
        {
          "type": "null"
        }
      ],
      "description": "The IANA time zone to save (e.g. \"Asia/Tokyo\"), or null to clear."
    }
  },
  "required": [
    "personId",
    "timeZone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "personId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "timeZone": {
      "anyOf": [
        {
          "type": "string",
          "description": "An IANA time-zone name, e.g. \"Asia/Tokyo\"."
        },
        {
          "type": "null"
        }
      ],
      "description": "The saved value — null when cleared."
    }
  },
  "required": [
    "personId",
    "timeZone"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}