> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alysio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Calendar

> Connect Alysio to Google Calendar

## 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 range\
Retrieving 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:

Timezone\
Week 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](https://www.googleapis.com/auth/calendar)                                     | Retrieve calendars and manage events             |
| [https://www.googleapis.com/auth/calendar.events](https://www.googleapis.com/auth/calendar.events)                       | Create and update calendar events                |
| [https://www.googleapis.com/auth/calendar.settings.readonly](https://www.googleapis.com/auth/calendar.settings.readonly) | Retrieve user calendar settings such as timezone |

These permissions allow Alysio to retrieve scheduling information and manage events on behalf of the connected user.

***

## 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 details\
What 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 using\
When 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 week\
List 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 event\
Get information about meeting abc123

***

### google\_calendar\_create\_event

Creates a new calendar event.

Example prompts

Schedule a meeting tomorrow at 2 PM\
Create 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 PM\
Change 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 meeting\
What 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.

Solution\
Navigate to Settings → Integrations and connect Google Calendar through OAuth.

***

### Authentication Error

The OAuth token may be expired or revoked.

Solution\
Reconnect the Google Calendar integration through the integrations settings.

***

### Insufficient Permissions

The integration may not have the required OAuth scopes.

Solution\
Ensure the integration is configured with the required calendar scopes.

***

### Incorrect Timezone or Date Range

Meeting times may appear incorrect if calendar settings are misconfigured.

Solution\
Verify the user’s timezone and calendar settings within Google Calendar.

***

## Support

For assistance configuring or troubleshooting the Google Calendar integration, contact

[support@alysio.ai](mailto:support@alysio.ai)

Your Alysio onboarding or account team can also assist with integration setup and configuration.