所有工具

list_calendar_events

日历 · macOS

效果: 读取. 状态: 受限可用.

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

macOS

用途

列出 Mac 日历应用(Calendar.app,本地/iCloud 日历)在某个日期范围内的事件,或通过 event_id 完整读取一个事件。列表条目会预览备注(200 个字符,带 notes_truncated 标志)并限制参与者数量;传入 event_id 可获得完整备注和完整参与者名单。默认范围为今天起 7 天。Microsoft 365 日历请使用 m365_list_events。

必填输入

此平台的架构未声明必填输入,但仍可能存在可选选择器或运行时要求。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作;请检查效果并取得授权。

英文规范技术架构macOS
{
  "properties": {
    "calendar": {
      "description": "Filter by calendar name — partial, case-insensitive (optional). To pick one of several same-titled calendars, qualify it as \"Account/Calendar\" (e.g. \"Exchange/Calendario\") using the source from list_calendar_names, or pass calendar_id.",
      "type": "string"
    },
    "calendar_id": {
      "description": "Filter by a single calendar UUID from list_calendar_names (optional).",
      "type": "string"
    },
    "calendar_ids": {
      "description": "Filter by multiple calendar UUIDs (optional).",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "end_date": {
      "description": "ISO 8601 date (YYYY-MM-DD). Defaults to start_date + 7 days.",
      "type": "string"
    },
    "event_id": {
      "description": "Read exactly ONE event by its id (from a previous list) with FULL notes and the complete attendee roster — required before editing notes of an event whose list entry says notes_truncated. When set, all other filters are ignored.",
      "type": "string"
    },
    "limit": {
      "description": "Max number of events to return (most recent first within the range). Optional; defaults to all in range.",
      "type": "integer"
    },
    "start_date": {
      "description": "ISO 8601 date (YYYY-MM-DD). Defaults to today.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

文档示例

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

{
  "limit": 5
}