Overview
The Google Calendar integration allows Alysio to securely connect with a user’s Google account to access and manage calendar data. Once connected, Alysio can retrieve upcoming meetings, view event details, create new events, update existing meetings, and analyze scheduling information using natural language queries. This allows users to interact with their calendar directly through Alysio without manually navigating the Google Calendar interface. All actions performed through the integration apply to the connected user’s Google account, including their primary calendar and any additional calendars they have permission to access. The integration enables Alysio to combine calendar context with conversation intelligence, revenue insights, and operational workflows across the revenue stack.Supported Data and Capabilities
The Google Calendar integration provides access to several key calendar objects and operations.Calendars
Retrieve information about calendars available to the connected user, including the primary calendar and any additional accessible calendars.Events
Retrieve, create, and update calendar events. Supported operations include: Listing events within a date rangeRetrieving full event details
Creating new events
Updating event attributes such as title, location, time, description, and attendees
Retrieving the next scheduled meeting
User Calendar Settings
Retrieve user-specific calendar settings including: TimezoneWeek start day
Locale preferences These settings allow Alysio to present meeting information using the correct time and date formatting for the user.
Authentication
The Google Calendar integration uses OAuth 2.0 authentication. Users connect their Google account through the Alysio Settings → Integrations panel. During the authorization process, the user grants Alysio permission to access calendar data using Google’s OAuth authorization flow. Once authorized, Alysio receives an OAuth access token that allows it to interact with the Google Calendar API on behalf of the user.Credential Handling
OAuth credentials are securely stored within the Alysio platform and automatically refreshed according to Google’s token refresh policies. Each user maintains their own integration connection, ensuring that calendar actions remain isolated to the individual’s account. If a user disconnects the integration or revokes access within Google, Alysio will no longer be able to retrieve or modify calendar data until the integration is reauthorized.Required Permissions and Scopes
The Google Calendar integration requests the following OAuth scopes.| Scope | Purpose |
|---|---|
| https://www.googleapis.com/auth/calendar | Retrieve calendars and manage events |
| https://www.googleapis.com/auth/calendar.events | Create and update calendar events |
| https://www.googleapis.com/auth/calendar.settings.readonly | Retrieve user calendar settings such as timezone |
MCP Tools
The Google Calendar MCP exposes several tools that allow Alysio to retrieve and manage calendar data through natural language queries.get_google_calendar
Retrieves details about a specific calendar, such as the primary calendar. Example prompts Show my Google calendar detailsWhat is my primary calendar
google_calendar_get_user_settings
Retrieves user-specific calendar settings including timezone, locale, and week start preferences. Example prompts What timezone is my calendar usingWhen does my calendar week start
google_calendar_list_events
Lists calendar events within a specified time range. Example prompts What meetings do I have this weekList my events between Monday and Friday
google_calendar_get_event
Retrieves detailed information about a specific calendar event using the event ID. Example prompts Show details for this eventGet information about meeting abc123
google_calendar_create_event
Creates a new calendar event. Example prompts Schedule a meeting tomorrow at 2 PMCreate a meeting with Jane next Tuesday from 10 to 11 Event parameters can include title, start time, end time, location, description, and attendees.
google_calendar_update_event
Updates an existing calendar event. Example prompts Move my 2 PM meeting to 3 PMChange the title of this event to QBR
google_calendar_get_next_event
Retrieves the next upcoming event from the user’s calendar. Example prompts What is my next meetingWhat is coming up next on my calendar
App Behavior
Alysio retrieves calendar information on demand when users request scheduling data or perform calendar-related actions. There is no background synchronization between Alysio and Google Calendar. Instead, API requests are executed in real time when users ask for event information or create or update events. When displaying event information, Alysio uses the user’s calendar settings such as timezone and week start preferences to ensure accurate date and time representation.Example Workflow
User asks What meetings do I have this week Alysio routes the request to the Google Calendar MCP. The MCP retrieves the user’s calendar settings using google_calendar_get_user_settings to determine timezone and week start preferences. The system queries events using google_calendar_list_events with the appropriate date range. The Google Calendar API returns the events. Alysio displays the meetings in the conversation interface using the user’s timezone.Troubleshooting
Google Calendar Not Connected
The user has not authorized the integration. SolutionNavigate to Settings → Integrations and connect Google Calendar through OAuth.
Authentication Error
The OAuth token may be expired or revoked. SolutionReconnect the Google Calendar integration through the integrations settings.
Insufficient Permissions
The integration may not have the required OAuth scopes. SolutionEnsure the integration is configured with the required calendar scopes.
Incorrect Timezone or Date Range
Meeting times may appear incorrect if calendar settings are misconfigured. SolutionVerify the user’s timezone and calendar settings within Google Calendar.