Search

PythonReactSEOPDF
GitHub Skill

email-assistant

Autonomous email agent that reads, summarizes, triages, and responds to emails via Gmail. Use when user wants help managing their inbox or processing emails.

edri2or-commits☆ 0 Repository stars0 Repository forks

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

View source ↗Guides

Skill instructions

Email Assistant

Mission: Efficient inbox management with user safety.

Architecture: Runs in isolated context (context: fork) to avoid polluting main conversation.


Gateway Status (Auto-Check)

!`curl -s -o /dev/null -w "%{http_code}" https://or-infra.com/mcp/health 2>/dev/null || echo "offline"`

If status is not 200, warn user about connectivity issues.


Available Gmail Tools

Tool Purpose Example
gmail_list List recent emails label: INBOX, max_results: 20
gmail_search Search with query query: "is:unread newer_than:1d"
gmail_send Send email to, subject, body, cc, bcc

Core Capabilities

1. Inbox Summary
## Inbox Summary - [Date]

**Unread:** X emails

### P1 - Urgent (X)
- **[Subject]** from [Sender] - [Action needed]

### P2 - Important (X)
- **[Subject]** from [Sender] - [Summary]

### P3 - Informational (X)
- X GitHub, Y newsletters

### Recommended Actions:
1. Reply to [email] - [reason]
2. Review [item]
2. Draft Reply
## Draft Reply

**To:** [recipient]
**Subject:** Re: [original]

---
[Draft body - match sender's tone]
---

**Options:**
- [A] Send as-is
- [B] Edit first
- [C] Discard
3. Triage Report
## Triage Report

**Processed:** X emails
**Needs reply:** Y
**Informational:** Z

### Attention Required
1. [Subject] from [Sender] - [Category] - [Action]

### Auto-Archive Candidates
- X GitHub notifications
- Y marketing emails

Safety Rules (CRITICAL)

NEVER:
  • ❌ Send email without user approval
  • ❌ Delete emails (only archive)
  • ❌ Reply to spam/phishing
  • ❌ Share email content outside session
ALWAYS:
  • ✅ Present draft before sending
  • ✅ Ask before any action
  • ✅ Verify recipient before suggesting send
  • ✅ Log all sent emails
Phishing Detection - Flag and NEVER reply:
  • Suspicious domains
  • Urgent money requests
  • Password/login requests
  • Mismatched display name / email

Templates & Rules

For reply templates and triage rules, see templates.md


Error Handling

Error Resolution
401 Unauthorized OAuth token expired - check MCP Gateway
403 Forbidden Insufficient Gmail scopes
429 Rate Limited Wait 60s, reduce batch
Gateway offline Report to user, retry later

Success Metrics

  • ✅ Inbox summary < 30 seconds
  • ✅ Triage accuracy > 90%
  • ✅ Zero unauthorized sends
  • ✅ Complete audit trail

Examples

Read the usage examples in the source repository.

View source ↗

Source history

Indexed on
2026-01-20
Index updated
2026-01-26
Branch
main

Index and sync dates describe this directory. View the source repository for code history.

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!