Google Calendar MCP
In one line: Connect Google Calendar so your UnleashX agent can find free time, book meetings, and manage events for you.
| Category | Productivity |
| Authentication | OAuth (Google sign-in) |
| Setup time | ~2 minutes |
| Difficulty | Easy |
| Best for | Scheduling, availability checks, and automated meeting booking from natural language |
1. Overview
Google Calendar is Google’s scheduling service. It stores your calendars, events, attendees, and free/busy information. Once connected, your UnleashX agent can list your calendars, check availability, find open time slots, create and update events (including meetings with attendees), add quick events from plain text, and delete events. Connecting Google Calendar to UnleashX means scheduling becomes conversational: ask “when am I free Thursday afternoon?” or “book a 30-minute call with Sam tomorrow at 4pm,” and the agent reads your calendar and acts — no manual clicking through day views.2. What you’ll need
A Google account with Calendar
Any personal Google account or a Google Workspace account with Calendar enabled.
Permission to grant access
You must be able to complete the Google sign-in and approve the requested permissions.
No admin access? On a managed Google Workspace account, your admin may need to allow UnleashX in the Google Admin console before authorization succeeds.
3. Get your credentials
Google Calendar uses Google OAuth 2.0. You do not create or paste an API key. UnleashX redirects you to Google, you sign in once, and Google issues an access token to UnleashX automatically.Start the connection in UnleashX
In your agent’s Data Connectors, find Google Calendar and click Connect (see Section 4). This launches Google’s secure sign-in page.
There is no key to copy. Access is granted by your Google sign-in and can be revoked anytime at your Google Account permissions page.
| Scope | Why UnleashX needs it |
|---|---|
https://www.googleapis.com/auth/calendar | Read and manage calendars and events (create, update, delete). |
https://www.googleapis.com/auth/calendar.events | Create, update, and delete individual events. |
https://www.googleapis.com/auth/calendar.readonly | List calendars and read events and free/busy info. |
https://www.googleapis.com/auth/userinfo.email | Identify which account is connected. |
https://www.googleapis.com/auth/userinfo.profile | Read your basic profile (name, picture). |
openid | Sign-in / identity verification. |
4. Connect on UnleashX
Open your agent
Sign in at https://www.tryunleashx.com and open your agent.
5. Available tools
| Tool | What it does | Changes data? |
|---|---|---|
| Get Availability | Get free/busy windows for a calendar in a time range. | No |
| Create Event | Create an event (flexible date/time parsing). | ✏️ Yes |
| Create Meeting | Create a meeting event with details. | ✏️ Yes |
| Delete Event | Delete an event. | ⚠️ Yes |
| Get Event | Get a single event by ID. | No |
| Get Events | Get events between a start and end time. | No |
| Update Event | Update an existing event. | ✏️ Yes |
| Get Current Datetime | Get the current date/time (optional timezone). | No |
| List Calendars | List calendars on the account. | No |
| List Events | List a calendar’s events (from now if no range given). | No |
| Find Available Times | Find open time slots in a range. | No |
| Check Availability | Check whether a time range is free or busy. | No |
| Retrieve Calendar Details | Get details of a specific calendar. | No |
| View Calendars | View calendars (alternate of list). | No |
| View Events | View events in a required time range. | No |
| Retrieve Event Details | Retrieve full details of an event. | No |
| Get Event Details | Get details of an event by ID. | No |
| Create Event Based on Past Event | Create a new event modeled on a past one. | ✏️ Yes |
| Add Attendees to Event | Add attendees to an existing event. | ✏️ Yes |
| Add Quick Event | Add an event from plain-text (“Quick Add”). | ✏️ Yes |
| Quick Add Event | Add an event from plain-text (“Quick Add”). | ✏️ Yes |
6. Example usage
“Am I free Thursday between 2pm and 5pm? If so, book a 45-minute review with priya@acme.com.” Runs Find Available Times / Check Availability, then Create Meeting (with Add Attendees to Event).
“Move tomorrow’s 10am standup to 11am.” Runs List Events / Get Events to locate it, then Update Event.
7. Permissions & data access
UnleashX can:- List calendars and read events and free/busy data.
- Create, update, and delete events.
- Add attendees and create quick events from text.
- Access Gmail, Drive, or other Google services unless connected separately.
- Change your Google account settings or password.
- Act on calendars you don’t have access to.
access-token header, a google_calendar_access_token header, or an Authorization: Bearer header, falling back to your UnleashX session), refreshed automatically when it expires.
8. Troubleshooting
| Problem | What it means | How to fix it |
|---|---|---|
401 Unauthorized | The access token is missing or expired. | Reconnect Google Calendar in Data Connectors. |
403 Forbidden | Missing scope or admin policy blocks the app. | Re-authorize and approve all scopes; ask your Workspace admin to allow UnleashX. |
404 Not Found | The calendar or event ID doesn’t exist or isn’t shared with you. | Verify the calendar/event ID and your access to it. |
| Event created at the wrong time | Time zone wasn’t specified. | Provide an explicit time zone; the agent defaults to Asia/Kolkata when none is given. |