Search Events
search_eventsSearch calendar events by date range, user, calendar, or contact. Returns complete event details, including attendees and recurrence patterns.
Instructions
Search for calendar events within a date range. Use this tool to find events by date, user, calendar, or contact.
RETURNS FULL DATA: Each result includes all event fields (name, dates, location, attendees, recurrence, etc.) - no need to call get_event afterward.
Supports filtering by:
Date range (start_date and end_date)
Specific users (by ID or name)
Specific calendars (by ID or name)
Specific contact
Use count_only=true for accurate counts on large datasets without returning the full result set.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination | |
| end_date | No | End of date range (ISO 8601) | |
| contact_id | No | Filter by contact ID (overrides other filters) | |
| count_only | No | When true, auto-paginates and returns only total count and breakdowns (no results array). Use for accurate counts on large datasets. | |
| start_date | No | Start of date range (ISO 8601) | |
| max_results | No | Max results (default 500, max 10000) | |
| user_filter | No | Filter by user IDs. Mutually exclusive with user_name_filter. | |
| sort_direction | No | ||
| calendar_filter | No | Filter by calendar IDs. Mutually exclusive with calendar_name_filter. | |
| user_name_filter | No | Filter by user names (case-insensitive, auto-resolved to IDs). Mutually exclusive with user_filter. | |
| calendar_name_filter | No | Filter by calendar names (case-insensitive, auto-resolved to IDs). Mutually exclusive with calendar_filter. |