gmail-operationslisted
Install: claude install-skill Verstige/gmail-operations
# Composio Gmail Operations
Running anything non-trivial against Gmail through Composio (`connect.composio.dev/mcp`) hits a small set of well-defined gotchas. This skill is the operational playbook distilled from running 100k+ message operations end-to-end.
Use this skill whenever the user asks to:
- Bulk delete, archive, or label a large number of Gmail messages
- Reclaim Gmail / Google account storage
- Organize an inbox by category (Personal, Business, Finance, etc.)
- Run a "cleanup my email" workflow
For initial Composio **setup** (OAuth, account linking, the "tools/list is empty" activation step), use the parent `native-mcp` skill. This one assumes you already have a working Composio session and access token.
## Architecture of a multi-thousand-message job
Do **not** try to fit a big Gmail job into a single chat turn. The right shape is a long-running worker script in the background, with state and logs written to disk. The agent's job is to design + launch the worker, then poll its log/state file.
```
[chat turn] [background process]
design worker ----> python worker.py (writes log + state)
launch it walks pages, batches deletes/labels
check log/state backoff on 401, auto re-init
report back
```
A working reference implementation is at:
`<hermes-home>/run/gmail_cleanup_worker.py` — drove a 165,724-message purge in this session.
Key shape of that worker:
1. `init()` — open MCP session, call `COMPOSIO