Search meetings and event details available to your Google account. An organization admin enables the source; every teammate connects their own account. Google controls which calendar and event details each person can read.
Admin setup uses your organization's Settings → Integrations page. Teammates connect from Integrations in the main sidebar. For workspace Search, use Search → Add source instead; Create & Invite is the workspace equivalent of Add source.
Set up the source
These steps require a Sim organization admin.
Add Google Calendar
Open Settings → Integrations → Providers, approve Google Calendar, then select Set up. Search uses Member accounts; an admin or service account cannot connect on behalf of everyone.
Choose the calendars
Leave Calendars empty to search each person's primary calendar. To include specific shared calendars, select them using Browse with, or switch to Calendar IDs and enter their IDs.
Browse with only helps you choose calendars. It does not connect your account for Search or grant teammates access.
Create the source
Keep the default date range for the previous and next 30 days, then click Add source. Each person, including the admin, connects their own account from the Sources list.
primary means the connected person's main calendar. A calendar selected from the list is a specific calendar ID, even when it is your main calendar. That same ID applies to every member, and only members with access to it can search its events.
Connect your account
- Join the Sim organization and verify your Sim email. Open Integrations and click Connect account beside Google Calendar.
- In the connection tab, choose the Google account whose verified email matches your Sim email. Grant the requested permissions.
- Return to Integrations to see indexing status and your searchable document count.
Teammates repeat only these connection steps after joining the organization. They do not need to configure the source. Connecting Gmail or Google Drive does not replace the Calendar connection.
Source options
An admin can change these under Manage on the source.
| Option | Behavior |
|---|---|
| Calendars / Calendar IDs | Empty defaults to each member's primary calendar. Explicit IDs restrict the source to those calendars. Multiple IDs are comma-separated; combine primary with shared calendar IDs if needed. |
| Date Range | Previous and next 30 days by default. Alternatives are the previous 30 days, next 30 days, or 90 days in each direction. The window moves forward on later syncs. |
| Search Query | Optional text filter applied by Google to event titles, descriptions, locations, and organizer or attendee names and emails. Leave empty to include all matching events in the date range. |
| Include Attendees | Yes by default. No omits organizer and attendee identity fields and keeps the attendee count. It does not redact names written into titles or descriptions. |
Document details contains optional metadata tags. Search hides sync frequency and the general knowledge-base Max Events setting.
What gets indexed
Sim indexes event titles, descriptions, times, locations, and the selected attendee information. All-day events and individual occurrences of recurring meetings are supported. Results link back to Google Calendar.
Cancelled events, attachment contents, meeting recordings, and transcripts are not indexed. Events outside the selected date window are excluded. Private event details that Google withholds are not available in Search; see Google's calendar sharing rules.
Search schedules syncs hourly. Event edits, cancellations, access changes, and events moving outside the date window are reconciled during background sync. The first sync may take longer, and results appear as indexing progresses.
Troubleshooting
| What you see | What to do |
|---|---|
| No events | Check the date range, search query, and calendar IDs. Use an empty calendar selection or primary for each person's own calendar. |
| A shared calendar is missing | Confirm the connected Google account can read its events. Selecting a calendar in Sim does not share it in Google. |
| Busy times without event details | Google may expose only availability or hide private details. Ask the calendar owner to review sharing if more access is appropriate. |
| A different email is requested | Choose the Google account matching your verified Sim email. |
| Reconnect | Click Reconnect and complete Google authorization again. Allow pop-ups if the connection tab does not open. |
| Unavailable or needs admin attention | Ask your Sim admin to check source status and the deployment's Google OAuth configuration. |
Self-hosted operator setup
The deployment operator configures Google OAuth once; teammates then use the normal connection flow.
- In Google Cloud Console, select your project. Open APIs & Services → Library, find Google Calendar API, and enable it.
- Open Google Auth platform → Branding and configure the app name and contact details. Under Audience, choose Internal for your Google Workspace organization only, or External for other users. Add test users while an external app is testing. Review Data Access → Add or remove scopes using the current Sim scopes below. See Google's consent and verification guidance.
- Open Google Auth platform → Clients → Create client, choose Web application, and add the URI below under Authorized redirect URIs. Add it to the existing Google client if the instance already uses one. See Google's credential setup.
- Save the client ID and secret as
GOOGLE_CLIENT_IDandGOOGLE_CLIENT_SECRET. SetNEXT_PUBLIC_APP_URLto the same Sim origin used in the callback, then restart Sim. See Integrations & OAuth.
https://<your-sim-domain>/api/auth/oauth2/callback/google-calendarThis Google Cloud example uses one client for all three services. Replace https://sim.example.com with your Sim origin and add only the callbacks for services you enable.
The current Sim Calendar connection uses these scopes:
openid
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/userinfo.profile
https://www.googleapis.com/auth/calendarSearch's reads can use calendar.events.readonly, calendar.calendarlist.readonly, and calendar.calendars.readonly for events, the calendar list, and calendar details. Sim currently shares its Calendar OAuth connection with workflow actions and requires the broader calendar scope above. Do not replace it with read-only scopes in this setup. Search does not change calendars or events. See Google's scope descriptions.