list_calendar_events
日历 · macOS
效果: 读取. 状态: 受限可用.
“受限可用”表示工具可能取决于版本、平台、权限、账户或配置,并不表示它在所有安装中都已启用。
macOS
用途
列出 Mac 日历应用(Calendar.app,本地/iCloud 日历)在某个日期范围内的事件,或通过 event_id 完整读取一个事件。列表条目会预览备注(200 个字符,带 notes_truncated 标志)并限制参与者数量;传入 event_id 可获得完整备注和完整参与者名单。默认范围为今天起 7 天。Microsoft 365 日历请使用 m365_list_events。
必填输入
此平台的架构未声明必填输入,但仍可能存在可选选择器或运行时要求。
权限与确认
架构未声明明确的确认参数。这并不代表可以未经许可操作;请检查效果并取得授权。
- 仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明,以了解其连接和权限要求;本目录不声称需要额外的 OAuth 范围或操作系统授权。
英文规范技术架构 — 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
}