Google Calendar

Experimental

The Google Calendar integration is experimental. Use with caution while this feature is being developed. Double-check events created or modified by the assistant before relying on them.

Clawbolt can connect to your Google Calendar so you can manage your schedule from the chat. Ask questions like “am I free Thursday afternoon?” or “schedule a site visit at the Johnson place for 9am tomorrow” and Clawbolt handles it.

What it can do

The integration provides five tools the agent uses to interact with Google Calendar:

Tool	Purpose	Approval
calendar_list_events	List events in a date range	Automatic
calendar_create_event	Create a new event	Asks permission
calendar_update_event	Update an existing event	Asks permission
calendar_delete_event	Delete an event	Asks permission
calendar_check_availability	Check free/busy time slots	Automatic

Read-only tools run automatically. Tools that modify your calendar ask for your confirmation first.

Setup

1. Create a Google Cloud project

1. Go to the Google Cloud Console and create a project (or use an existing one)
2. Enable the Google Calendar API under APIs & Services
3. Configure the OAuth consent screen (External type is fine for personal use)

2. Create OAuth credentials

1. Go to APIs & Services > Credentials
2. Click Create Credentials > OAuth client ID
3. Select Web application as the application type
4. Add your Clawbolt URL as an authorized redirect URI: https://<your-domain>/api/oauth/callback
5. Copy the Client ID and Client Secret

3. Configure Clawbolt

Add these to your .env file:

GOOGLE_CALENDAR_CLIENT_ID=your_client_id
GOOGLE_CALENDAR_CLIENT_SECRET=your_client_secret

Also make sure APP_BASE_URL is set to your public-facing URL so the OAuth callback works:

APP_BASE_URL=https://your-clawbolt-domain.com

4. Connect your account

Users can connect their Google account in two ways:

• Over chat (preferred): Ask the assistant “connect my Google Calendar” and it will generate an authorization link. The user taps the link, signs in, and the callback page confirms the connection.
• From the dashboard: Open the Tools page (/app/tools), find Google Calendar, and click Connect.

Once connected, the calendar tools become available to the agent.

Example conversations

Checking your schedule

You: What do I have tomorrow?

Clawbolt: Here's your schedule for tomorrow (March 25):
          - 8:00 AM: Site visit at Johnson residence
          - 11:30 AM: Lunch with supplier
          - 2:00 PM: Estimate walkthrough at 42 Oak St

Scheduling a job

You: Schedule a bathroom remodel at the Davis place for next
     Monday 8am to 4pm

Clawbolt: I'd like to create this event:
          "Job: Davis - Bathroom remodel"
          Monday March 30, 8:00 AM - 4:00 PM
          Approve?

You: Yes

Clawbolt: Done! Event created on your calendar.

Checking availability

You: Am I free Friday afternoon?

Clawbolt: You have a gap from 1:00 PM to 5:00 PM on Friday.
          Want me to schedule something?

Timezone handling

Clawbolt uses your timezone (set in your user profile) when interpreting times. If you say “9am tomorrow”, it means 9 AM in your local time, not UTC.

Disconnecting

To disconnect Google Calendar, go to the Tools page in the web dashboard and click Disconnect next to Google Calendar. This revokes the OAuth token. You can reconnect at any time.

Reference

See the Configuration page for the full list of environment variables.