Gmail Tool

External tool for Gmail operations via OAuth2 API access.

Invocation via use_tool

{"tool": "use_tool", "arguments": {"tool_name": "gmail", "action": "ACTION", "args": {...}}}

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-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/