Google Workspace

Gmail, Contacts, Calendar, Drive (with comments), Docs, and Sheets for OpenClaw agents

Google Workspace Skill

Access Gmail (read-only), Google Calendar (configurable), Google Contacts (read-only), Google Drive (configurable, with comments), Google Docs (configurable), and Google Sheets (configurable).

Installation

Download the latest release binary for linux/arm64 and install to ~/.openclaw/bin/:

bash

TAG=$(curl -fsSL "https://api.github.com/repos/PanthroCorp-Limited/openclaw-skills/releases" \
  | grep -o '"tag_name":"google-workspace/v[^"]*"' | head -1 | cut -d'"' -f4)
VERSION=${TAG#google-workspace/v}
curl -fsSL "https://github.com/PanthroCorp-Limited/openclaw-skills/releases/download/${TAG}/google-workspace_${VERSION}_linux_arm64.tar.gz" \
  | tar -xz -C ~/.openclaw/bin/ google-workspace
chmod +x ~/.openclaw/bin/google-workspace

Important

• Gmail is strictly read-only. You cannot send, modify, or delete emails.
• Contacts is strictly read-only. You cannot create, modify, or delete contacts.
• Drive, Calendar, Docs, and Sheets access depends on the configured mode. Check with google-workspace config show.
• Drive file creation/deletion is not supported. Drive write access is limited to comments.
• Docs and Sheets default to off. Enable them with config set before use.
• Setting --drive=readwrite requests the full drive OAuth scope, which grants broad access to all Drive files at the token level. Only enable this if the operator accepts that risk.

Check configuration

Before using any commands, verify what is enabled:

text

google-workspace config show

Gmail commands

Search messages:

text

google-workspace gmail search --query "from:[e-mail]" --max-results 10

Read a message by ID:

text

google-workspace gmail read --id MESSAGE_ID

List labels:

text

google-workspace gmail labels

Search or read threads:

text

google-workspace gmail threads --query "subject:meeting"
google-workspace gmail threads --id THREAD_ID

Calendar commands

List available calendars:

text

google-workspace calendar list

List upcoming events:

text

google-workspace calendar events --from 2026-03-29T00:00:00Z --to 2026-04-05T23:59:59Z

Get a specific event:

text

google-workspace calendar event --id EVENT_ID

Create an event (only if calendar mode is readwrite):

text

google-workspace calendar create --summary "Team sync" --start "2026-04-01T10:00:00Z" --end "2026-04-01T11:00:00Z"

Update an event (only if calendar mode is readwrite):

text

google-workspace calendar update --id EVENT_ID --summary "Updated title"

Delete an event (only if calendar mode is readwrite):

text

google-workspace calendar delete --id EVENT_ID

Contacts commands

List contacts:

text

google-workspace contacts list --max-results 50

Search contacts:

text

google-workspace contacts search --query "John"

Get a specific contact:

text

google-workspace contacts get --id "people/c1234567890"

Drive commands

List files:

text

google-workspace drive list --max-results 20

Search files:

text

google-workspace drive list --query "name contains 'report'" --max-results 10

Get file metadata:

text

google-workspace drive get --id FILE_ID

Download file content (Google Docs export as plain text, Sheets as CSV):

text

google-workspace drive download --id FILE_ID

List comments on a file:

text

google-workspace drive comments list --file-id FILE_ID

Add a comment (requires readwrite mode):

text

google-workspace drive comment --file-id FILE_ID --content "Looks good, approved."

Reply to a comment (requires readwrite mode):

text

google-workspace drive comment reply --file-id FILE_ID --comment-id COMMENT_ID --content "Thanks!"

Docs commands

Read a document:

text

google-workspace docs read --document-id DOC_ID

Insert text (requires readwrite mode):

text

google-workspace docs edit --document-id DOC_ID --insert-text "Hello" --index 1

Find and replace (requires readwrite mode):

text

google-workspace docs edit --document-id DOC_ID --find "old text" --replace-with "new text"

Sheets commands

List sheets in a spreadsheet:

text

google-workspace sheets list --spreadsheet-id SPREADSHEET_ID

Read cell values:

text

google-workspace sheets read --spreadsheet-id SPREADSHEET_ID --range "Sheet1!A1:C10"

Write cell values (requires readwrite mode):

text

google-workspace sheets write --spreadsheet-id SPREADSHEET_ID --range "Sheet1!A1:B2" --values '[["Name","Score"],["Alice","95"]]'

Authentication status

Check if the token is valid:

text

google-workspace auth status

If the token has expired, ask the operator to re-authenticate by running google-workspace auth login on the host.

If authentication fails with Error 400: policy_enforced, the operator's Google account likely has Advanced Protection enabled. They will need to temporarily unenroll, complete the OAuth flow, then re-enroll. The refresh token persists across sessions.

Output format

All commands output JSON by default. Use --output text for plain text where supported.