Book Google Meet

Create scheduled Google Calendar events with OPEN access Google Meet spaces.

Create scheduled Google Calendar events with OPEN access Google Meet spaces.

Quick Start

bash

# 1. Install dependencies
pip install -r requirements.txt

# 2. Get OAuth credentials from Google Cloud Console
#    - Enable Google Calendar API and Google Meet API
#    - Create OAuth 2.0 Desktop app credentials
#    - Download client_secrets.json

# 3. Place client_secrets.json in the skill directory

# 4. Run the script
python book_meeting.py --title "My Meeting" --date "2026-03-12" --time "15:00" --duration 45 --timezone "Asia/Shanghai"

Prerequisites

1. Google Cloud Project Setup

1. Go to Google Cloud Console
2. Create a new project
3. Enable APIs:
   • Google Calendar API
   • Google Meet API

2. OAuth Consent Screen

1. Go to OAuth consent screen
2. Select External user type
3. Fill in app name and contact email
4. Add scope: https://www.googleapis.com/auth/meetings.space.settings
5. Set publishing status to In production

3. Create OAuth Credentials

1. Go to Credentials
2. Click Create Credentials → OAuth client ID
3. Select Desktop app application type
4. Download JSON and save as client_secrets.json

Alternative: Set environment variables instead of using client_secrets.json:

bash

export GOOGLE_CLIENT_ID='your-client-id'
export GOOGLE_CLIENT_SECRET='your-client-secret'

Required OAuth Scopes

text

https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/meetings.space.settings

Note: Use meetings.space.settings (non-sensitive) instead of meetings.space.created (sensitive).

Usage

Basic Usage

bash

python book_meeting.py --title "Team Meeting" --date "2026-03-12" --time "15:00" --duration 45 --timezone "Asia/Shanghai"

With Attendees

bash

python book_meeting.py --title "Team Meeting" --date "2026-03-12" --time "15:00" --duration 45 \
  --timezone "Asia/Shanghai" \
  --attendees "[e-mail],[e-mail]"

With Description

bash

python book_meeting.py --title "Team Meeting" --date "2026-03-12" --time "15:00" --duration 45 \
  --timezone "Asia/Shanghai" \
  --description "Weekly sync meeting"

Access Types

bash

# OPEN - Anyone with link can join (default)
python book_meeting.py --title "Public Meeting" --date "2026-03-12" --time "15:00" --duration 45 \
  --timezone "Asia/Shanghai" --access-type OPEN

# TRUSTED - Org members + invited external users
python book_meeting.py --title "Internal Meeting" --date "2026-03-12" --time "15:00" --duration 45 \
  --timezone "Asia/Shanghai" --access-type TRUSTED

# RESTRICTED - Only invitees
python book_meeting.py --title "Private Meeting" --date "2026-03-12" --time "15:00" --duration 45 \
  --timezone "Asia/Shanghai" --access-type RESTRICTED

Command Line Options

Option	Description	Default
--title, -t	Meeting title (required)	-
--date, -d	Meeting date (YYYY-MM-DD)	-
--time	Meeting start time (HH:MM)	-
--duration	Duration in minutes	45
--timezone, -z	Timezone	America/New_York
--attendees	Comma-separated email list	-
--description	Meeting description	-
--access-type	OPEN, TRUSTED, or RESTRICTED	OPEN
--credentials, -c	Path to client_secrets.json	client_secrets.json
--token-path	Path to store OAuth token	meeting_token.pickle

Output Example

text

🚀 Step 1: Creating Calendar event with Meet conference...
✅ Calendar event created with Meet conference
   Meeting Code: abc-defg-hij

🚀 Step 2: Looking up Meet space using meeting code...
✅ Found Meet space: spaces/xxxxxxxxxx

🚀 Step 3: Patching Meet space to OPEN access...
✅ Meet space patched successfully!
   Access Type: OPEN

============================================================
✅ Meeting created successfully!
============================================================

📅 Title: Team Meeting
🕐 Start: 2026-03-12T15:00:00
🕐 End: 2026-03-12T15:45:00
🌐 Timezone: Asia/Shanghai

🔗 Meet URL: https://meet.google.com/abc-defg-hij
📞 Meeting Code: abc-defg-hij
🔓 Access Type: OPEN
🆔 Space Name: spaces/xxxxxxxxxx

📧 Calendar Link: https://calendar.google.com/calendar/event?eid=...
🆔 Event ID: xxxxxxxxxxxxxx
============================================================

How It Works

1. Calendar API - Create event with Meet conference
2. Meet API (spaces.get) - Look up Meet space using meeting code
3. Meet API (spaces.patch) - Update space to set accessType=OPEN

Troubleshooting

403 Permission Denied

Cause: Using meetings.space.created scope (sensitive) without additional verification.

Solution: Use meetings.space.settings scope (non-sensitive) instead. Already fixed in the script.

API Not Enabled

Enable both APIs in Google Cloud Console:

• Calendar API: https://console.developers.google.com/apis/api/calendar.googleapis.com/overview
• Meet API: https://console.developers.google.com/apis/api/meet.googleapis.com/overview

Invalid Credentials

Delete meeting_token.pickle to force re-authentication:

bash

rm meeting_token.pickle

Files

• book_meeting.py - Main script
• client_secrets.json - OAuth credentials (you provide)
• meeting_token.pickle - Cached OAuth token (auto-generated)
• requirements.txt - Python dependencies

Security Notes

⚠️ Sensitive Files:

File	Description	Security
meeting_token.pickle	Cached OAuth tokens (contains refresh token)	Keep secure; delete when not needed; do not commit to version control
client_secrets.json	OAuth client credentials	Never commit to version control; protect as password

⚠️ Token File Warning: The script writes meeting_token.pickle to disk after first OAuth authorization. This file contains sensitive OAuth tokens including refresh tokens that can be used to access your Google account. Protect this file:

• Do not share it
• Do not commit it to version control
• Delete it when no longer needed
• Ensure proper file permissions (readable only by owner)

References

• Google Calendar API
• Google Meet API
• Meet spaces.get
• Meet spaces.patch