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
"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:
- Go to your existing Google Cloud project
- APIs & Services → Library → search "Google Calendar API"
- Click Enable
- 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
Sign in and create a new project. Name it "OpenClaw" or similar.
APIs & Services → Library → search "Google Calendar API" → Enable
Create OAuth Credentials
APIs & Services → OAuth consent screen. Choose External (or Internal for Workspace). Fill in app name, emails, save and continue.
Credentials → Create Credentials → OAuth client ID. Type: Desktop app. Download the JSON file.
OAuth consent screen → Test users → Add your email. Required while the app is in testing mode.
Connect to OpenClaw
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:
- Open the URL in your browser
- Sign in with Google
- Click through the "unverified app" warning (Advanced → Go to app)
- Grant calendar permissions
- 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:
OpenClaw chains these together automatically.
Permissions Explained
Calendar API scopes you might see:
- calendar.readonly — Can only view events, not modify
- calendar.events — Can create, edit, delete events
- calendar — Full access including calendar settings
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."