> For the complete documentation index, see [llms.txt](https://docs.perisclaw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perisclaw.com/skills-and-integrations/calendar.md).

# Calendar

Connect your calendar and Perisclaw manages your schedule from inside WhatsApp — where your conversations are already happening. It has full context of your calendar there, so you never switch apps to check, book, or move anything. Times are handled in your own timezone, and meetings get a Google Meet link automatically.

## Connecting your calendar

{% stepper %}
{% step %}

### Ask in your self-chat

Just say *"connect my calendar"* in your [self-chat](/getting-started/using-perisclaw.md). Perisclaw replies with a secure link.
{% endstep %}

{% step %}

### Authorize with Google

Tap the link and approve access on Google's screen. It's a one-time sign-in.
{% endstep %}

{% step %}

### Start managing your time

Perisclaw confirms the connection, and you can start asking right away.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Perisclaw connects with **Google Calendar** today. Support for other providers like Outlook, and for multi-calendar setups, is in progress.
{% endhint %}

## What you can do with it

### Manage your schedule

Anything you'd open the calendar app for, you can do in WhatsApp. Ask what's on today or this week and Perisclaw lists it. Tell it to set up a meeting and it creates the event, adds a Google Meet link, and invites whoever you name. Ask it to push something back or cancel it, and it updates your calendar for you.

{% hint style="info" %}
*"Book a meeting with Rahul tomorrow at 10am."*
{% endhint %}

![Perisclaw listing the day's schedule, flagging a 4:30 PM conflict between Board Prep and a Client Call, and offering to reschedule or block prep time](/files/eNfo2loSvh4dbFMR6dpJ)

### Get context before a meeting

Walking into a meeting cold means scrambling to remember what it's about. Perisclaw tells you who you're meeting and the background — pulling from your past chats and emails with them — so you're prepared before it starts.

{% hint style="info" %}
*"Brief me on my 3pm with Infosign."*
{% endhint %}

### Check availability and conflicts

When someone proposes a time in any chat, you don't have to switch over to see if it works. Perisclaw checks your calendar and tells you whether you're free or have a clash. It also keeps you ahead of what's coming, flagging double-bookings before they catch you out.

{% hint style="info" %}
*"/claw what time works for a 30-min call with Maya tomorrow?"*
{% endhint %}

### Coordinate and book without leaving a chat

When you need to find a time with someone, hand the whole thing to Perisclaw. In the chat with that person, ask it to find a slot — it checks your availability, does the back-and-forth with them, settles on a time that works for both, then blocks your calendar and sends the invite. You set it off and get back a booked meeting. (This is an [autonomous job](/what-perisclaw-can-do/autonomous-jobs.md) — Perisclaw keeps at it until the meeting's locked.)

{% hint style="info" %}
*"/claw coordinate a coffee meeting with this group for next week."*
{% endhint %}

### Block time for your work

Things you commit to in chat need time to actually get done — and that time tends to vanish. When a task or deadline comes up in a conversation, Perisclaw can offer to block time for it on your calendar, so the work has a place to happen instead of getting squeezed out by meetings.

{% hint style="info" %}
*"Block 2 hours for deep work this afternoon."*
{% endhint %}

## Disconnecting your calendar

You're always in control. If you ever want to disconnect:

{% tabs %}
{% tab title="In WhatsApp" %}
Just ask Perisclaw to *"disconnect Google"* or *"revoke Google access"* and it'll stop using the integration.
{% endtab %}

{% tab title="In Google settings" %}
Go to your **Google Account → Security → Third-party apps with account access** and remove Perisclaw's permissions.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
The same Google sign-in also covers [Drive & Sheets](/skills-and-integrations/drive-and-sheets.md) — if you've connected your calendar, there's nothing separate to authorize for those.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.perisclaw.com/skills-and-integrations/calendar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.