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
Suivez les instructions du dépôt pour votre agent. Consultez les fichiers et dépendances avant l’installation.
Voir la source ↗GuidesInstructions
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
Exemples
Consultez les exemples du dépôt source.
Voir la source ↗Historique source
- Date d’indexation
- 2026-01-20
- Mise à jour de l’index
- 2026-01-26
- Branch
- main
Les dates concernent ce répertoire. Consultez le dépôt pour l’historique du code.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!