gmail-actions

Send, reply, label, triage, and delete Gmail messages with explicit action authorization.

609|81|Updated Nov 15, 2024
One-click install
npx skills add https://github.com/QuixiAI/Hexis --skill gmail-actions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail-actions
Source: https://github.com/QuixiAI/Hexis/tree/main/skills/installed/gmail-actions
Command: npx skills add https://github.com/QuixiAI/Hexis --skill gmail-actions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents unauthorized or accidental Gmail operations by requiring explicit user requests or database-owned connector action policies before sending, replying, labeling, triaging spam, or deleting messages.

Core Features & Use Cases

  • Outbound Messaging: Send new emails and reply to existing threads using gmail_send and gmail_reply with explicit recipients, subjects, and bodies.
  • Mailbox Organization: Apply or remove labels and triage spam by marking messages as spam, not-spam, or archiving them.
  • Policy-Gated Autonomy: Heartbeat-triggered actions only run when a matching connector action policy exists in the database; deletions are Trash-only by default and never autonomous.
  • Use Case: A user asks the agent to reply to a specific thread and archive a spam message; the skill verifies the request is explicit in the current conversation, then calls gmail_reply and gmail_spam_triage without escalating beyond the stated intent.

Quick Start

Ask the agent to send an email to a specific recipient with a subject and body, or to reply to a named thread, after connecting your Gmail account.

Frequently Asked Questions about gmail-actions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an email through Gmail with an AI agent?▼

Connect your Gmail account, then make an explicit request in the conversation with the recipient, subject, and body. The skill calls gmail_send with those parameters and keeps the message aligned with your stated intent.

How do I reply to a Gmail thread automatically?▼

Ask for a reply to a specific thread in the current conversation. The skill calls gmail_reply with the thread_id, recipient, subject, and body you specify, without expanding into broader correspondence.

Can the agent delete Gmail messages on its own?▼

No. Deletion is never autonomous and never happens during heartbeats. The agent only calls gmail_delete when you name a specific message, and permanent deletion requires you to explicitly request irreversible removal.

Does Gmail automation work during heartbeat cycles?▼

Heartbeat actions require a matching connector action policy stored in the database. If no policy exists, the skill does not improvise; ongoing behavior must first be established through connector-action-authorization.

How do I mark Gmail messages as spam or archive them?▼

Request spam triage explicitly and the skill calls gmail_spam_triage with mark_spam, mark_not_spam, or archive options. Label changes use gmail_label with explicit add_label_ids and remove_label_ids.