Overview
The Google Calendar integration answers schedule questions such as “what’s on my calendar on Thursday?”, “when do I next meet Priya?”, or “who is in the planning review tomorrow?”. It supports only. Live only means Hyperspell reads events from Google Calendar at the moment a question is asked and does not store them. Calendars change too often for a stored copy to stay truthful, and a schedule answer that is a day old is worse than no answer. The trade-off is that calendar events never become part of the company brain: they are not indexed, do not appear in the memories browser, and content rules do not apply to them.Authentication
Google Calendar is a personal integration. Each person connects their own Google account through an OAuth sign-in, and Hyperspell asks for read-only access to their calendars and events. There is no shared connection, because a calendar belongs to a person rather than to the company. Events are fetched with the connecting person’s own access at query time, so each person, and every agent they connect, sees only their own calendar. Nothing about anyone’s schedule is visible to colleagues through the brain.Dealing with Google access issues
If, while connecting to a Google Service using OAuth, you get an error about “This app is blocked”, you need an admin to unblock it.This app is blocked
1
Go to admin.google.com
2
Go to Security → Access and data control → API controls
3
Click Manage Third-Party App Access (under “App access control”)
4
Click Add app → OAuth App Name Or Client ID
5
Paste the client ID:This is the client ID of the Hyperspell OAuth app.
6
Select the app in the results, choose All users (or the relevant OU/group), click Continue
7
Set access to Trusted (“Can access all Google services”) → Configure / Save
What a query returns
When someone asks a schedule question, Hyperspell lists the events in the relevant time window and returns each one with:- The title, start, and end.
- The location and the meeting link, such as a Google Meet link.
- The organizer and attendees.
- The event description.
- If the question names a date or range, that is the window Hyperspell searches. A question without dates, such as “what is on my calendar?”, covers the past seven days and the next sixty, up to 100 events sorted by start time.
- Recurring events come back as the specific occurrence inside the window, not the series. Asking about Thursday returns Thursday’s instance of the weekly all-hands, with Thursday’s date.
- Events without a start time are skipped, since they cannot answer a schedule question.
Search options
The Google Calendar integration does not support any custom search options.Limitations
- Free and busy questions such as “is Priya free at 3pm?” are not supported yet. The brain sees events, not availability.
- Because nothing is stored, Hyperspell cannot answer questions about past attendance beyond what a live listing of the requested window shows.