list_calendar_events
캘린더 · macOS
효과: 읽기. 상태: 조건부 제공.
‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.
macOS
목적
Mac의 캘린더 앱(Calendar.app, 로컬/iCloud 캘린더)에서 날짜 범위의 일정을 나열하거나 event_id로 하나의 일정을 전체 조회합니다. 목록 항목은 메모를 200자까지 미리 보여 주고 notes_truncated 플래그를 표시하며 참석자 수도 제한합니다. 전체 메모와 참석자 명단을 가져오려면 event_id를 전달하세요. 기본 범위는 오늘부터 7일입니다. Microsoft 365 캘린더에는 m365_list_events를 사용하세요.
필수 입력
이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.
권한 및 확인
스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.
- 이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.
영문 정식 기술 스키마 — 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
}