# Gmail

> Read and send Gmail messages and threads via Gmail API.

- Skill: `xaiht/gmail` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xaiht/gmail`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xaiht/gmail/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: XAIHT (https://skillmd.com/u/xaiht)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/xaiht/gmail

---

<!--
═══════════════════════════════════════════════════════════════════
  ✦  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

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.