xuiltul

gmail-tool

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.

xuiltul 254 45 Updated 5mo ago
GitHub

Install

npx skillscat add xuiltul/animaworks/templates-en-common-skills-gmail-tool

Install via the SkillsCat registry.

About this skill

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.

SKILL.md

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/

Categories