| name | gmail-tool |
| description | 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. |
| tags | ["communication","gmail","email","external"] |
Gmail Tool
External tool for Gmail operations via OAuth2 API access.
Invocation via Bash
Use Bash with animaworks-tool gmail <subcommand> [args]:
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
{"tool_name": "gmail", "action": "unread", "args": {"max_results": 20}}
read_body — Read email body
{"tool_name": "gmail", "action": "read_body", "args": {"message_id": "message ID"}}
draft — Create draft
{"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)
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/
