find the calendar event behind a half-remembered name

the meeting is next week. the title has completely left your head. give the bot a topic, person or date range and it finds candidates in one google calendar.

by the dusk bot team · checked 12 november 2026 · how we made this

descriptions and attendee details can match too. ask for dates beside the results so you can spot the appointment without opening every day yourself.

pixel art: a cyan pixel bot and a blue pixel bot beside the Google Calendar mark on a white tile, an alarm clock and a calendar and a pair of binoculars, on a grassy meadow in front of green terraced fields, one saying "which appointment was it"

what it does

a topic and a date window beat scrolling through a busy month. the search covers titles, descriptions, locations and people. name the calendar as well as the clue. broad words bring back more candidates.

need every training date? ask for each occurrence of repeating meetings within that window. the bot must follow further results even after an empty batch.

when you would use it

find a guest’s workshop. their name may appear only in the description.
recover an old discussion. search last quarter by the office-move venue.
plan around an absence. find out-of-office entries before arranging customer time.
list training dates. request each occurrence of a repeating course.

try it

paste this into a chat with your bot

every other wednesday at 2, search my work google calendar for events mentioning sablewing in the next fortnight.

- include individual dates of recurring meetings
- show the calendar, title, date and start time here
- finish reading all result batches

leave unrelated matches as candidates for me to choose. never move appointments or contact attendees.

when: alternate wednesdays at 14:00
needs: google calendar connected with read only for the work calendar

what comes back looks like this (an example)

sablewing matches
client workshop: thursday, 14:00, work calendar
site visit: next monday, 11:00, work calendar
no events changed.

set it up

start with read only. connect google calendar for the search bot.
give it a clue. name the calendar and what the meeting involved.
try a short window. include your time zone and compare a result with the appointment in your calendar.
keep the useful search running. inspect its next runs and pause when the project ends.

what it needs from you

input	required	what it is
`query`	no	Free-text search terms to find events.
`order_by`	no	Order of events: 'startTime' (ascending by start time) or 'updated' (ascending by last modification time).
`time_max`	no	Upper bound (exclusive) for an event's start time to filter by.
`time_min`	no	Lower bound (exclusive) for an event's end time to filter by.
`page_token`	no	Token from a previous response's `nextPageToken` to fetch the subsequent page of results.
`calendar_id`	no	Identifier of the Google Calendar to query.

from composio's catalog for Google Calendar (action GOOGLECALENDAR_FIND_EVENT, read 12 november 2026⁴). your bot fills these in from what you tell it.

how dusk bot handles it

dusk bot counts Find event as a read: it looks and changes nothing. a bot you allow only to read can use it.

the permissions Google Calendar asks for to run it: calendar, calendar.readonly, calendar.events, calendar.events.readonly.

where it stops

ask what matched. an unfamiliar title can belong to the right meeting if the clue appears in its people or description.
one batch may leave meetings out. ask the bot to finish the search.
get actual dates for a repeating meeting. request individual occurrences rather than one series.

try it in 2 minutes

connect google calendar with read only
name the calendar and a person or topic
give a start date, end date and time zone
open the closest match and compare its people, topic and date

mistakes people make

asking for "the training" without dates

name the calendar and a short date window first.

getting one result for a repeating meeting

ask for individual occurrences within your chosen dates.

questions

can it find a meeting from a person’s name?

yes, people can be the clue. search also checks attendee and organiser details. add dates to cut unrelated matches.

can it search all my calendars at once?

name each calendar you want searched. this action searches one at a time; the bot can search them separately.

sources

dusk bot docs: files and apps
dusk bot docs: routines
dusk bot docs: a bot's computer
composio, Google Calendar toolkit (catalog version 20261103_00), checked 12 november 2026

drafted with ai help from the dusk bot docs and the sources listed on this page, then checked against them. if something here is wrong or out of date, write to [email protected].