Calendar search
The Calendar search tool lets you search and retrieve events from supported calendars, then use those events in agents. It supports Google Calendar and Microsoft Outlook Calendar. Your available capabilities depend on your calendar provider, permissions, and administrator configuration.
After your administrator sets up the calendar provider, you can:
- Query calendar events in Glean: ask questions about your past and upcoming calendar events directly in Glean
- Retrieve calendar events in the agent builder: build agents that search and retrieve calendar data
- Find meetings in Search: search for calendar events and transcripts within Glean Search
- Summarize meetings on the Glean homepage: use meeting summarization to understand key decisions and action items
Calendar search also supports these use cases when your administrator enables the required federated calendar access:
- Search a colleague's calendar when you have permission to view it
- Search common or shared calendars, such as holiday and release calendars
- Search an extended history of up to 12 months, depending on the provider and configuration
Supported calendars
| Calendar | Setup | Provider-specific notes |
|---|---|---|
| Google Calendar | Set up Google Calendar | Federated searches use current calendar authorization and support primary, peer, and shared calendars |
| Microsoft Outlook Calendar | Set up Microsoft 365 tools | Federated searches use current Microsoft authorization and support primary, peer, and shared calendars |
Inputs
Provide a natural-language query or a structured operator query in the Calendar search step. You can also configure the number of results returned.
| Input or setting | What to provide | Example |
|---|---|---|
| Natural-language query | Describe the meetings you want to find | my next meeting with John |
| Calendar source | Select the calendar provider to search | Google calendar or Microsoft calendar |
| Peer calendar | Search a colleague's calendar when you have permission to view it | A colleague's name or email address |
| Shared calendar | Search a common or shared calendar, such as a holiday or release calendar | The calendar name or identifier |
| Date filters | Use after: and before: with now or a quoted date | after:"2025-04-01" before:"2025-04-30" |
| Meeting filters | Use updated:, organizer:, or participants: to narrow results | updated:past_week organizer:"alex@example.com" |
| Number of Results | Choose how many events the step returns. The default is Let AI decide | As many as possible |
The type: operator filters by event type. Supported values include default, focusTime, outOfOffice, and workingLocation.
For examples of supported search syntax, see Advanced search filters.
Outputs
The tool returns calendar events that match your query and that the running user can view. Results enter the agent's context rather than appearing directly to the user, so later steps can use them. For example, follow Calendar search with a Think or Respond step to summarize meetings, extract action items, or propose next steps. When available, results identify the source calendar so downstream steps can distinguish primary, peer, and shared calendars.
Usage examples
- Minimal: "What meetings do I have tomorrow?" returns your upcoming events for the next day.
- Typical: Combine "Summarize my meetings from last week" with an operator query such as
updated:past_weekto scope the search to recent events. - Advanced:
after:"2025-04-01" before:"2025-04-30" organizer:"alex@example.com"finds meetings from a specific organizer within a date range, which an agent can then summarize or use to propose next steps.
Prerequisites
-
Calendar search uses federated access to retrieve current calendar data. Before you use the tool, set up the relevant calendar provider and make sure users have current federated calendar authorization. See Supported calendars for setup links and provider-specific requirements.
-
For Google Calendar, complete the Google Calendar setup, including the required Calendar API and delegated
calendar.readonlyscope. -
For Microsoft Outlook Calendar, complete the Microsoft 365 setup and confirm that Microsoft authorization tokens and federated-search configuration remain current. Outlook email setup alone does not configure calendar search.
Configuration
Enable calendar search in an agent:
- Go to the Glean app.
- Select Agents and click Create Agent.
- Select the step of an agent.
- Search for and select the Calendar search tool.
- Provide a natural language input, for example, "Search for my next meeting with John" or a search operator input, for example,
after:now before:2025-04-29).
To retrieve exhaustive calendar results, set Number of Results to As many as possible. The default setting is Let AI decide.
Limitations
- Calendar search is available only in Thinking mode, not Fast mode
- Follow-up queries through the meeting summarization modal are not currently supported
- Calendar search only retrieves events; it does not create or change them. Separate calendar write actions may be available through skills or MCP tools when your organization enables and seeds those tools. See Outlook tools for supported Outlook actions.