# Gmail Tool

> Gmail integration tool for unread checks, reading bodies, and drafts via OAuth2 Gmail API access. Use when: reading inbox mail, fetching message bodies, writing drafts, or searching labeled mail.

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

---


# Gmail Tool

External tool for Gmail operations via OAuth2 API access.

## Invocation via Bash

Use **Bash** with `animaworks-tool gmail <subcommand> [args]`:

```bash
animaworks-tool gmail unread [-n 20]
animaworks-tool gmail read MESSAGE_ID
animaworks-tool gmail draft --to ADDR --subject SUBJ --body BODY [--thread-id TID]
```

## Actions

### unread — List unread emails
```json
{"tool_name": "gmail", "action": "unread", "args": {"max_results": 20}}
```

### read_body — Read email body
```json
{"tool_name": "gmail", "action": "read_body", "args": {"message_id": "message ID"}}
```

### draft — Create draft
```json
{"tool_name": "gmail", "action": "draft", "args": {"to": "recipient@example.com", "subject": "Subject", "body": "Body text", "thread_id": "thread ID (optional)"}}
```

## CLI Usage (S/C/D/G-mode)

```bash
animaworks-tool gmail unread [-n 20]
animaworks-tool gmail read MESSAGE_ID
animaworks-tool gmail draft --to ADDR --subject SUBJ --body BODY [--thread-id TID]
```

## Notes

- OAuth2 authentication flow required on first use
- credentials.json and token.json must be in ~/.animaworks/