gmail-tool

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": "[e-mail]", "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/