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.
Install
npx skillscat add xuiltul/animaworks/templates-en-common-skills-gmail-tool Install via the SkillsCat registry.
We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing language, no superlatives, no calls to action. Must be at most 60 words. No quotes, no markdown. Just plain text. Provide only the summary text. We need to explain what skill does, what problem it solves, when to use it. Let's craft: "The gmail-tool provides command‑line access to Gmail via OAuth2, allowing users to list unread messages, read email bodies, and create drafts. It solves the need to automate inbox monitoring, message retrieval, and draft creation within scripts or workflows.
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/