Google Calendar AI Agent Integration

Overview

The Google Calendar integration connects your Claws to your team’s calendars through Google’s OAuth flow. Once authorized, a Claw can read event details, check availability across team members, create and update events, send invitations, and manage recurring schedules, all from within its isolated ClawCage container. Whether you need automated meeting scheduling, agenda preparation, or calendar-driven workflow triggers, your Claw handles the coordination.

You choose the access level during setup. Read-only mode lets your Claw view calendars and check availability without creating or modifying events. Full access enables event creation, updates, and deletion. The OAuth scopes match exactly what you select.

What Your Claw Can Do

Read calendars and events. Your Claw can access event details including titles, descriptions, attendees, locations, and conference links. It can read across multiple calendars (personal, team, and shared resource calendars) to build a complete view of your schedule.

Check availability. Query free/busy information across team members to find open time slots. Your Claw can check availability for multiple people simultaneously and suggest meeting times that work for everyone, respecting time zones and working hours.

Create and update events. With full access, your Claw can create new events with all standard fields: title, description, attendees, location, reminders, and conferencing. It can update existing events to adjust times, add attendees, or modify descriptions.

Send invitations. When creating or updating events, your Claw can automatically send invitation emails to attendees. Responses (accepted, declined, tentative) are tracked on the event.

Manage recurring events. Claws handle recurring event patterns: weekly standups, monthly reviews, daily syncs. They can create, modify, or cancel individual instances or entire series.

Who Can Reach Your Claw

Calendar whitelisting controls which calendars and users your Claw interacts with:

• By calendar owner. Whitelist specific users whose calendars the Claw can access. Only authorized calendars are visible.
• By specific calendar ID. Whitelist individual calendar IDs for precise control. The Claw accesses only those calendars and nothing else.

This works alongside three Claw scoping levels:

Private Claw. Only the creator interacts. Your Claw manages your personal calendar: preparing meeting agendas, suggesting schedule optimizations, and alerting you to conflicts. Example: a personal scheduling assistant that reviews your upcoming week, drafts agendas for each meeting using context from Slack and email, and blocks focus time.

Team Claw. Whitelisted team members share the Claw. It manages a team calendar, coordinates standups, and helps team members find meeting times. Only whitelisted members can request scheduling. Example: an engineering team Claw that schedules sprint ceremonies, posts meeting agendas in Slack, and follows up with action items after each meeting.

Organization-wide Claw. Any org member can request scheduling help. The Claw can check availability across the organization, book conference rooms, and coordinate cross-team meetings. Whitelisted to the company domain.

Security

• OAuth scope minimization. Read-only requests calendar.readonly. Full access requests calendar. No additional scopes.
• Tokens encrypted at rest. Calendar OAuth tokens are stored with AES-256 encryption and decrypted only inside the ClawCage.
• ClawCage isolation. Each Claw runs in its own Docker container with calendar credentials injected securely at runtime.
• Audit logging. Every calendar API call is logged in the ClawStaff dashboard.
• Revoke anytime. Disconnect from ClawStaff or Google account settings to immediately invalidate tokens.

How It Works

1. Connect Google Calendar. Start a Google Workspace connection and enable Calendar. Choose read-only or full access.
2. Authorize with Google. Review the calendar-specific OAuth scopes and click Allow.
3. Configure your Claw. Define which calendars to access, scheduling preferences, and automation rules.
4. Claw manages your schedule. Your Claw reads and manages calendar events from within its ClawCage, coordinating across your team and tools.

Cross-Integration Workflows

Google Calendar combined with other tools enables smart scheduling automation:

• Slack to Calendar. A team member posts “let’s sync this week” in Slack. Your Claw checks availability for all participants, proposes a time, and creates the event with a Google Meet link, all from the Slack conversation.
• Calendar to Slack. Your Claw posts a daily schedule summary in a Slack channel each morning with today’s meetings, agendas, and prep notes pulled from Notion or Google Docs.
• Jira sprint to Calendar. When a new sprint starts, your Claw creates calendar events for the sprint planning, daily standups, and retrospective based on the sprint dates in Jira.
• Meeting ended to Google Docs. After a calendar event ends, your Claw creates a Google Doc with meeting notes, action items discussed in Slack during the meeting, and follow-up tasks.