search_events
Search Microsoft 365 calendar events by subject or organizer name. List events within a time range using keywords or time-based filters.
Instructions
Search or list calendar events by keywords. Returns matching events with summary information. If no query is provided, lists events within the specified time range. All time parameters use your local timezone. When using time_range, the response includes a user-friendly display string (e.g., 'Today', 'This Week', 'This Month'). Returns: {success: boolean, events: array, count: integer, date_range: string, timezone: string}. Note: Subject search uses exact substring matching, organizer search uses fuzzy matching.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search query. For 'subject': event title text. For 'organizer': organizer name. Optional - if not provided, lists events within the time range | |
| end_date | No | End date in your local timezone (e.g., '2024-12-31' or '2024-12-31T23:59') (optional) | |
| start_date | No | Start date in your local timezone (e.g., '2024-01-01' or '2024-01-01T14:30') (optional) | |
| time_range | No | Time range type (case-insensitive, optional, in your local timezone). Accepted values: 'today', 'tomorrow', 'this_week', 'next_week', 'this_month', 'next_month' (any case). If provided, overrides start_date and end_date. Returns a user-friendly display string in the response. Examples: 'today', 'Today', 'THIS_WEEK', 'Next_Month'. | |
| search_type | No | Field to search in (optional). Options: 'subject' (search by event title with exact substring matching), 'organizer' (search by organizer name/email with fuzzy matching). Default: 'subject' |