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.