All posts
OpenClaw Google Calendar & Gmail Integration Setup

OpenClaw Google Calendar & Gmail Integration Setup

|4 min read

Google Calendar and Gmail are the two most popular integrations for OpenClaw. Once connected, your AI assistant can read your schedule, draft emails, and manage your day — all from Telegram.

What You Can Do

Calendar

  • "What's on my calendar today?"
  • "Schedule a meeting with John next Tuesday at 2 PM"
  • "Move my 3 PM meeting to Thursday"
  • "Block 2 hours for deep work tomorrow morning"
  • "Do I have any conflicts next week?"

Gmail

  • "Check my email for anything urgent"
  • "Draft a reply to the email from Client X"
  • "Send a follow-up to everyone I met at the conference"
  • "Summarize my unread emails from today"
  • "Archive all newsletters from this week"

Setup Guide

Step 1: Create Google Cloud Project

  1. Go to Google Cloud Console
  2. Create a new project (name it "OpenClaw" or similar)
  3. Enable the following APIs:
    • Google Calendar API
    • Gmail API

Step 2: Configure OAuth Consent Screen

  1. Navigate to APIs & Services → OAuth consent screen
  2. Choose "External" user type
  3. Fill in app name, support email
  4. Add scopes:
    • calendar.readonly
    • calendar.events
    • gmail.readonly
    • gmail.send
    • gmail.modify
  5. Add your email as a test user

Step 3: Create OAuth Credentials

  1. Go to APIs & Services → Credentials
  2. Create OAuth 2.0 Client ID
  3. Application type: Web application
  4. Add redirect URI: http://localhost:3000/oauth/callback (or your OpenClaw instance URL)
  5. Download the credentials JSON file

Step 4: Install OpenClaw Skills

openclaw plugins install @anthropic/mcp-google-calendar
openclaw plugins install @anthropic/mcp-gmail

Step 5: Configure Credentials

openclaw config set mcpServers.google-calendar.env.GOOGLE_CLIENT_ID "your-client-id"
openclaw config set mcpServers.google-calendar.env.GOOGLE_CLIENT_SECRET "your-client-secret"

openclaw config set mcpServers.gmail.env.GOOGLE_CLIENT_ID "your-client-id"
openclaw config set mcpServers.gmail.env.GOOGLE_CLIENT_SECRET "your-client-secret"

Step 6: Authorize

Open the authorization URL provided by OpenClaw, log in with your Google account, and grant permissions. The tokens are stored securely on your instance.

Automation Examples

Smart Scheduling

"I need to meet with Sarah this week. Check both our calendars and suggest 3 times that work."

OpenClaw checks your calendar, finds free slots, and suggests options. If Sarah shares her calendar, it checks hers too.

Email + Calendar Combo

"Check my email for any meeting invitations I haven't responded to."

OpenClaw scans Gmail for calendar invites, cross-references with your actual calendar, and tells you which need attention.

Meeting Prep

"I have a meeting with Client X in 30 minutes. Summarize our recent email threads and any notes I have about them."

Daily Email Digest

Set up a scheduled task:

"Every day at 9 AM, summarize my unread emails from the last 12 hours. Group by sender importance."

Auto-Decline

"If I get a meeting invitation for Friday afternoons, automatically decline with 'I keep Fridays for focused work.'"

Security Notes

  • OAuth tokens are stored locally on your OpenClaw instance
  • Tokens can be revoked anytime from your Google Account settings
  • Use the minimum required scopes
  • For Gmail, gmail.readonly is sufficient if you only need reading — add gmail.send only if you want OpenClaw to send emails

Google Workspace Accounts

For Google Workspace (business) accounts:

  • Your admin may need to allow the OAuth app
  • Domain-wide delegation can be configured for team deployments
  • Service accounts work for automated access without user interaction

On ClawTank

ClawTank simplifies the OAuth flow — configure your Google credentials in the dashboard and authorize with one click. Your tokens are stored securely in your isolated container.

Get Started

Deploy on ClawTank, connect Google Calendar and Gmail, and let your AI assistant manage your schedule and inbox through Telegram.

Ready to deploy OpenClaw?

No Docker, no SSH, no DevOps. Deploy in under 1 minute.

Get started free