所有工具

create_calendar_event

日历 · macOS

效果: 写入. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置,并不表示它在所有安装中都已启用。

macOS

用途

在 Mac 的日历应用(Calendar.app)中创建事件。必须提供 title、start_date 和 end_date。可以选择通过电子邮件邀请参与者(仅限 CalDAV/Exchange 日历),或使用 `recurrence`(daily/weekly/monthly/yearly)创建重复事件。若使用 Microsoft 365,请改用 m365_create_event。

必填输入

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构声明了明确的确认参数。请检查预览,并按此平台的契约授权实际操作。

英文规范技术架构macOS
{
  "properties": {
    "attendees": {
      "description": "List of email addresses to invite (optional, CalDAV/Exchange only)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "calendar": {
      "description": "Calendar name to match (optional, alternative to calendar_id)",
      "type": "string"
    },
    "calendar_id": {
      "description": "Calendar UUID from list_calendar_names (optional, defaults to default calendar)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to create the event",
      "type": "boolean"
    },
    "end_date": {
      "description": "ISO 8601 date or datetime, same timezone rules as start_date. For an all-day event pass a bare date (end is inclusive: same date as start = a one-day all-day event; a later date spans through that day).",
      "type": "string"
    },
    "location": {
      "description": "Location (optional)",
      "type": "string"
    },
    "notes": {
      "description": "Event notes (optional)",
      "type": "string"
    },
    "recurrence": {
      "description": "Make it a repeating event: 'daily', 'weekly', 'monthly', or 'yearly' (optional; omit for a one-time event).",
      "type": "string"
    },
    "recurrence_count": {
      "description": "Total number of occurrences (optional). Mutually exclusive with recurrence_until; if neither is given the event repeats indefinitely.",
      "type": "integer"
    },
    "recurrence_interval": {
      "description": "Repeat every N periods (optional, default 1 — e.g. recurrence='weekly' + recurrence_interval=2 = every 2 weeks).",
      "type": "integer"
    },
    "recurrence_until": {
      "description": "ISO 8601 date the repetition stops on (optional; takes precedence over recurrence_count).",
      "type": "string"
    },
    "start_date": {
      "description": "ISO 8601 date or datetime. With a time (2026-06-27T09:00:00) the event is timed; a time with NO timezone is read in the Mac's LOCAL zone, append Z or an offset (2026-06-27T09:00:00Z, or +02:00) to pin it to UTC/another zone. Pass a bare DATE (YYYY-MM-DD) for BOTH start_date and end_date to create an ALL-DAY event.",
      "type": "string"
    },
    "title": {
      "description": "Event title",
      "type": "string"
    }
  },
  "required": [
    "title",
    "start_date",
    "end_date"
  ],
  "type": "object"
}

文档示例

create_calendar_event 的文档示例。请勿执行此示例。所示参数属于虚构数据集;在实际调用前,请解析真实标识符并获得授权。

{
  "confirm": false,
  "end_date": "2026-10-06T11:00:00",
  "start_date": "2026-10-06T10:00:00",
  "title": "Planning meeting"
}