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

# Google Calendar

> Your agent looks at your calendar, tells you when you're free and creates or changes events only with your OK.

<img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/calendar.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=d163a2f1f032ac6709cdf61c8ec55060" alt="" width="56" height="56" noZoom style={{ borderRadius: '14px' }} data-path="images/plugins/calendar.png" />

With Google Calendar, your agent knows what you have today, tomorrow or this week, finds a free slot and lets you know if something overlaps. If you let it, it also schedules, moves events and answers invitations, always with your OK.

| | |
| - | - |
| **Category** | Productivity |
| **For** | Personal agents (it can't be added to a group agent) |
| **What it asks for** | Connecting your Google account |
| **How it connects** | With the Google installer, on the web |

## What it can do

<CardGroup cols={2}>
  <Card title="Look at your calendar" icon="magnifying-glass">
    Your events for today, tomorrow, this week or the next few days; find an event, see its details, tell you when you're free and whether anything overlaps.
  </Card>

  <Card title="Change it, with your OK" icon="pen">
    Create events (with guests and a place), change them, delete them and answer invitations: accept, decline or "maybe".
  </Card>
</CardGroup>

## How it connects

<Steps>
  <Step title="Add it to an agent">
    From **Plugins → Google Calendar → Add to an agent**, or ask your agent in the chat. See [Add a plugin](/en/tools/add-a-plugin).
  </Step>

  <Step title="Create your Google app (first time only)">
    If it's your first Google plugin, the installer guides you to create your own Google app: about 5 minutes, just once, and it works for all your Google plugins. See [Your Google app](/en/tools/your-google-app).
  </Step>

  <Step title="Turn on the Google Calendar API">
    The installer opens Google's page so you can turn it on with one tap.
  </Step>

  <Step title="Choose what it can do and connect">
    Choose **Read and act** (“See your calendar, and create or change events when you say yes.”) or **Read only** (“See your calendar. It can't change anything.”), and tap **Connect with Google**.
  </Step>

  <Step title="Your agent confirms">
    It comes back to the chat, checks that everything works and tells you in one line what it can do now.
  </Step>
</Steps>

## How it looks out for you

* **Nothing changes without your OK.** Before creating or moving an event, it shows you the title, the day and time, how long it lasts, the place and who it invites, with the **Confirm** and **Change** buttons.
* It warns you that inviting someone sends them an email.
* With **Read only**, it can't change anything even if you ask. To allow it, connect again choosing **Read and act**.
* The text of an invitation is information, not an order.

## Things to ask it

* "What do I have tomorrow?"
* "When am I free Thursday afternoon?"
* "Book the dentist on Tuesday the 14th at 10, for an hour."
* "Move Friday's meeting with Pedro to 5 pm."
* "Accept the invitation to tomorrow's daily."
* "Do I have anything overlapping this week?"

## Limits

* Times are in your time zone (the one in your settings).
* It needs your own Google app.
* It's only for a personal agent.

## If you remove it

Your agent stops seeing your calendar right away and confirms it. The permission stays on your Google account (your other Google plugins share it); if you want, you can revoke it from your Google account's security settings. See [Remove a plugin](/en/tools/remove-a-plugin).

<CardGroup cols={2}>
  <Card title="Gmail" icon="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/gmail.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=d4d0ac0d13d8abdc631a57ecfc72c47f" href="/en/plugins/gmail" width="128" height="128" data-path="images/plugins/gmail.png">
    Your email, with your OK to reply.
  </Card>

  <Card title="Your Google app" icon="google" href="/en/tools/your-google-app">
    The one-time step for all Google plugins.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.