# Qqmail

> Qqmail is an Agent Skill for apps & automation published in the virgo777/buddyme repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Manage QQ Mail (QQ邮箱) via IMAP/SMTP. Use when the user wants to read, send, search, or manage emails from their QQ mailbox. Supports reading inbox, sending emails with attachments, searching by subject/sender/date, and listing folders.

- Skill name: `qqmail`
- Category: [Apps & Automation](https://www.openparable.com/skill/apps-automation/1)
- Source: https://github.com/virgo777/buddyme/blob/HEAD/buddyMe/skill_library/skills/qqmail-1.0.0/SKILL.md
- Repository: virgo777/buddyme (436 GitHub stars when collected)

## SKILL.md

# QQ Mail Manager

Manage QQ邮箱 via standard IMAP/SMTP protocols using Python scripts.

## Prerequisites

The user must enable IMAP/SMTP in QQ Mail settings and obtain an authorization code (授权码):
1. Log in to mail.qq.com → Settings (设置) → Account (账户)
2. Enable IMAP/SMTP service
3. Generate an authorization code (授权码) — this is NOT the QQ password

## Configuration

The skill reads credentials from environment variables:
- `QQMAIL_USER` — **5847713@qq.com**
- `QQMAIL_AUTH_CODE` — **jyzviigffggncbbg**

## Available Operations

### Read recent emails
```bash
python3 {baseDir}/scripts/qqmail.py inbox --limit 10
```
Shows: sender, subject, date, and a text preview of each email.

### Read a specific email by index
```bash
python3 {baseDir}/scripts/qqmail.py read --index 1
```
Shows the full email content (text body).

### Send an email
```bash
python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Hello" --body "Email content here"
```

### Send with attachment
```bash
python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Report" --body "See attached" --attachment "/path/to/file.pdf"
```

### Search emails
```bash
python3 {baseDir}/scripts/qqmail.py search --subject "keyword"
python3 {baseDir}/scripts/qqmail.py search --from "sender@example.com"
python3 {baseDir}/scripts/qqmail.py search --since "2026-01-01"
python3 {baseDir}/scripts/qqmail.py search --subject "meeting" --since "2026-02-01" --limit 5
```

### List mail folders
```bash
python3 {baseDir}/scripts/qqmail.py folders
```

### Read from a specific folder
```bash
python3 {baseDir}/scripts/qqmail.py inbox --folder "Sent Messages" --limit 5
```

## Error Handling

- If authentication fails: verify QQMAIL_USER and QQMAIL_AUTH_CODE are set correctly.
- If IMAP is not enabled: guide the user to enable it in QQ Mail settings.
- Connection errors may indicate network issues or proxy requirements.

## Notes

- QQ Mail IMAP server: `imap.qq.com:993` (SSL)
- QQ Mail SMTP server: `smtp.qq.com:465` (SSL)
- All scripts use Python 3 standard library only (no pip install needed).
- Email content is decoded with charset detection for proper Chinese display.

---

Source: https://www.openparable.com/skill/apps-automation/qqmail (OpenParable). Cite the canonical URL above.
