Gmail (tc)

Read, send, and manage Gmail emails, threads, labels, and drafts via Gmail API

Audits

Pending

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPending

Multi-engine malware detections and file reputation.

Install

openclaw skills install tc-gmail

Gmail Skill

Overview

Integrate with Gmail to send/receive emails, manage threads and labels, and work with drafts. Uses official Gmail API with OAuth 2.0 authentication.

Configuration

Set these environment variables:

Variable	Description
`GMAIL_CLIENT_ID`	Google Cloud OAuth client ID
`GMAIL_CLIENT_SECRET`	Google Cloud OAuth client secret
`GMAIL_REFRESH_TOKEN`	OAuth refresh token for your Gmail account

Usage Examples

Send an email

{
  "tool": "gmail_send",
  "parameters": {
    "to": "recipient@example.com",
    "subject": "Meeting Reminder",
    "body": "Hi there,\n\nJust a reminder about our meeting tomorrow at 10 AM.\n\nBest regards,\nYour AI Assistant",
    "cc": ["cc@example.com"],
    "attachments": ["/workspace/documents/agenda.pdf"]
  }
}

Search for emails

{
  "tool": "gmail_search",
  "parameters": {
    "query": "is:unread subject:invoice after:2026-03-01",
    "max_results": 10,
    "include_body": false
  }
}

Get email details

{
  "tool": "gmail_get_message",
  "parameters": {
    "message_id": "msg_1234567890abcdef",
    "format": "full"
  }
}

List labels

{
  "tool": "gmail_list_labels"
}

Modify message labels

{
  "tool": "gmail_modify_labels",
  "parameters": {
    "message_id": "msg_1234567890abcdef",
    "add_labels": ["STARRED"],
    "remove_labels": ["UNREAD"]
  }
}

Query Operators

Use these in the search query:

is:unread - Unread messages
is:starred - Starred messages
from:sender@example.com - From specific sender
to:recipient@example.com - To specific recipient
subject:keyword - Subject contains keyword
after:2026/01/01 - Messages after date
before:2026/12/31 - Messages before date
has:attachment - Messages with attachments