Provides safe Gmail interaction via API with built-in approval gates for sending.

Install

mkdir -p .claude/skills/gmail-stelios12312312 && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14138" && unzip -o skill.zip -d .claude/skills/gmail-stelios12312312 && rm skill.zip

Installs to .claude/skills/gmail-stelios12312312

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

How to read, draft, and send emails via Gmail API for the Tesseract operator
76 charsno explicit “when” trigger
Beginner

Key capabilities

  • List Gmail messages
  • Get a single message by ID
  • List unread inbox messages
  • Create a draft
  • Send an email

How it works

The skill uses the Gmail API to perform email operations like listing, getting, drafting, and sending messages.

Inputs & outputs

You give it
Gmail query string (e.g., 'is:unread')
You get back
List of Gmail messages or a created draft

When to use gmail

  • Listing unread inbox messages
  • Creating email drafts automatically
  • Sending pre-approved lead responses
  • Managing email communications

About this skill

Gmail — Reference Skill

Authentication

  • OAuth2 via service account or stored credentials
  • Default account: GMAIL_DEFAULT_ACCOUNT_ID env var
  • Connector: tesseract_operator/connectors/gmail.py
  • Skills: tesseract_operator/skills/gmail_skills.py

Available Skills (5 total)

SkillRiskMCPDescription
gmail.listLOWList Gmail messages
gmail.getLOWGet a single message by ID
gmail.inbox_unreadLOWList unread inbox messages
gmail.create_draftMEDIUMCreate a draft (safe, no send)
gmail.sendHIGHSend an email — requires approval

Usage Pattern

gmail = ctx.extras["gmail"]
# List unread
messages = gmail.list_messages(query="is:unread", max_results=20)
# Create draft (safe, with HTML signature automatically appended)
draft = gmail.create_draft(to="[email protected]", subject="Follow-up", body="Hi...", append_signature=True)
# Send requires approval gate

Known Gotchas

  1. gmail.send is HIGH risk and NOT MCP-exposed — requires explicit CLI invocation
  2. Always CC [email protected] on lead replies (rule G-010)
  3. Default account is [email protected]
  4. G-030: Never include sender name in body — Gmail auto-appends the signature. End at "Με εκτίμηση," or "Best regards," only.
  5. G-032: Before drafting ANY lead reply, read docs/email_rules.md first. It has brochure attachment rules, voice/language rules, and email templates.

When not to use it

  • When explicit CLI invocation is not possible for sending emails
  • When not adhering to specific email rules like CC requirements or signature guidelines

Limitations

  • Sending emails requires approval and is a high-risk operation.
  • Specific rules apply to lead replies, such as CC requirements and signature formatting.
  • The sender name should not be included in the email body due to automatic signature appending.

How it compares

This skill automates email tasks with built-in safety checks and rule enforcement, unlike manual Gmail usage.

Compared to similar skills

gmail side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gmail (this skill)02moNo flagsBeginner
sendgrid-automation14moNo flagsIntermediate
gmail-manager274moReviewIntermediate
zendesk154moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

Search skills

Search the agent skills registry