> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.deepmask.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Events

`outlook_search_events`

Full-text search across the user's calendar events using KQL (Keyword Query Language) syntax. Searches subject, body, location, and attendees. Returns event previews with IDs you can pass to `outlook_get_event` for full details.

## Parameters

| Parameter         | Type   | Required | Description                                                                                                                                           |
| ----------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`           | string | Yes      | Search query using KQL syntax — e.g. `"quarterly review"`, `"\"team standup\""`, `"organizer:alice@company.com"`, `"location:\"Conference Room A\""`. |
| `limit`           | number | No       | Max results to return (1–100, default 20).                                                                                                            |
| `offset`          | number | No       | Results to skip for pagination (default 0).                                                                                                           |
| `response_format` | string | No       | Output format: `"markdown"` (default) or `"json"`.                                                                                                    |

## Returns

An array of matching event objects with preview data.

<Info>
  KQL supports phrases (`"exact phrase"`), field-scoped queries (`organizer:user@domain.com`, `location:"Room Name"`), and boolean operators. For simple keyword searches, plain text works without any special syntax.
</Info>

## Example use

> "Find all calendar events related to the Q3 planning review."