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.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill 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)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!