Connect OpenClaw to Google Calendar

~8 min setup · Same process as Gmail if you've done that

OpenClaw can be your calendar assistant. Ask about your schedule, create events with natural language, get reminders before meetings, and find free time slots across busy weeks.

Already set up Gmail? You can add Calendar to the same Google Cloud project. Skip to adding the Calendar API.

What You Can Do

Example prompts
"What's on my calendar today?"

"Schedule a call with Mike next Tuesday at 2pm"

"When am I free this week for a 1-hour meeting?"

"Remind me 15 minutes before my next meeting"

"Move my 3pm to 4pm and notify attendees"

Quick Setup (If You Already Have Gmail Connected)

If you've already done the Gmail integration, adding Calendar is simple:

  1. Go to your existing Google Cloud project
  2. APIs & Services → Library → search "Google Calendar API"
  3. Click Enable
  4. That's it—your existing OAuth credentials will work

Tell OpenClaw: "Set up Google Calendar integration" and it'll handle the rest.

Full Setup (Starting Fresh)

Create Google Cloud Project

1 Go to console.cloud.google.com

Sign in and create a new project. Name it "OpenClaw" or similar.

2 Enable Google Calendar API

APIs & Services → Library → search "Google Calendar API" → Enable

Create OAuth Credentials

3 Configure consent screen

APIs & Services → OAuth consent screen. Choose External (or Internal for Workspace). Fill in app name, emails, save and continue.

4 Create OAuth client ID

Credentials → Create Credentials → OAuth client ID. Type: Desktop app. Download the JSON file.

5 Add yourself as test user

OAuth consent screen → Test users → Add your email. Required while the app is in testing mode.

Connect to OpenClaw

6 Tell OpenClaw to set it up

Send: "Set up Google Calendar integration" — OpenClaw will guide you through placing the credentials and authorizing.

Authorization Flow

First time you use a calendar command, OpenClaw gives you a URL:

  1. Open the URL in your browser
  2. Sign in with Google
  3. Click through the "unverified app" warning (Advanced → Go to app)
  4. Grant calendar permissions
  5. Paste the auth code back to OpenClaw

After that, it just works. Tokens refresh automatically.

Useful Workflows

Morning Briefing

Set up a daily reminder: "Every morning at 8am, tell me my schedule for the day and highlight any prep I need."

Smart Scheduling

"Find 3 possible times next week where both my calendar and Sarah's calendar are free for 45 minutes."

(Requires Sarah to share her calendar with you, or you having access to it.)

Meeting Prep

"30 minutes before each meeting today, remind me who's attending and what we discussed last time."

Travel Buffer

"For any in-person meetings, add 30 minutes of travel time before."

Combining Gmail + Calendar

This is where it gets powerful. With both connected:

Combined workflow
"Check my email for meeting requests. For each one, check if I'm free at the proposed time. If yes, draft an acceptance. If not, suggest alternative times."

OpenClaw chains these together automatically.

Permissions Explained

Calendar API scopes you might see:

For most use cases, calendar.events is enough. You can limit scopes in your OAuth consent screen if you want read-only access.

Troubleshooting

Can't see my calendars

Make sure you authorized the correct Google account. You might have multiple accounts—check which one you signed in with during OAuth.

Events not showing

OpenClaw queries your primary calendar by default. If you use multiple calendars, specify: "What's on my Work calendar today?"

Can't create events

Check that you granted write permissions during OAuth. If you only allowed read access, you'll need to re-authorize with broader scope.

Pro tip: Combine calendar with reminders. "Remind me to prepare meeting notes 1 hour before any meeting with 'review' in the title."