gmail git:20261022.8c577d3A

Immutable. This exact content never changes and is served at /api/v1/blob/5d8d605b9111be38.

---
name: gmail
description: Read and send Gmail messages and threads via Gmail API.
metadata:
  openclaw:
    emoji: "📧"
    requires:
      env: ["GMAIL_OAUTH_TOKEN"]
    primaryEnv: "GMAIL_OAUTH_TOKEN"
  tlamatini:
    runtime: in-process
    requires_tools: ["chat_agent_apirer"]
    requires_mcps: []
    budget:
      max_iterations: 4
      max_seconds: 60
      max_tokens: 10000
    permissions:
      filesystem: { read: [], write: [] }
      shell:     []
      network:   allow
      db:        deny
    inputs:
      - { name: action, type: enum,
          values: ["search","get","send","reply","label"], required: true }
      - { name: payload, type: object, required: true }
    outputs:
      - { name: response, type: object, required: true }
    triggers:
      keywords: ["gmail","email","mailbox","inbox"]
---
<!--
═══════════════════════════════════════════════════════════════════
  ✦  T L A M A T I N I  ✦   —   "one who knows"
  Created by  Angela López Mendoza   ·   @angelahack1
  Developer · Architect · Creator of Tlamatini
  Tlamatini Author Banner — do not remove (Angela's name is kept in every build)
═══════════════════════════════════════════════════════════════════
-->

# Gmail skill

> Current release: **[v1.90.0](../../../../docs/changes/2026-10-22-v1.90.0.md)**. Dated records below retain their original evidence dates.


> **HEADLESS IS FORBIDDEN. VISIBLE FOREGROUND EXECUTION ONLY.** Every command, automated test, diagnostic, script, build, agent and browser must run in a visible foreground window on Angela's real desktop. Use forked CMD/PowerShell windows, `execute_forked_window: true`, and `headless: false`. Monitor live; if visibility cannot be confirmed, do not run. Read the [mandatory execution policy](../../../../TestsVisiblesAndVisibleExecutionFromClaude2Codex.md).

Use the Gmail API. Acquire an OAuth token through Google's standard flow
and place in `GMAIL_OAUTH_TOKEN`.

## Endpoints

- `search` → `GET /gmail/v1/users/me/messages?q=<q>`
- `get`    → `GET /gmail/v1/users/me/messages/{id}`
- `send`   → `POST /gmail/v1/users/me/messages/send`
- `reply`  → same as send, with `threadId` set
- `label`  → `POST /gmail/v1/users/me/messages/{id}/modify`

Bodies for `send` use base64url-encoded RFC 2822 messages.