# Zmail

> Zmail Skill - Custom Email for Agents

- Skill: `idanbeck/zmail` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add idanbeck/zmail`
- Raw SKILL.md: https://api.skillmd.com/api/skills/idanbeck/zmail/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: idanbeck (https://skillmd.com/u/idanbeck)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/idanbeck/zmail

---

# Zmail Skill - Custom Email for Agents

Read and send email through the Zmail server at mail.zergai.com.

## Setup

Create `config.json`:

```json
{
  "api_url": "https://mail.zergai.com",
  "api_key": "your-api-key-here",
  "default_mailbox": "fake-idan@zergai.com"
}
```

## Usage

```bash
# Check server health
python zmail_skill.py health

# List inbox
python zmail_skill.py inbox
python zmail_skill.py inbox --mailbox fake-idan@zergai.com
python zmail_skill.py inbox --limit 50

# Read a message
python zmail_skill.py read 123
python zmail_skill.py read 123 --json

# Send an email
python zmail_skill.py send --to user@gmail.com --subject "Hello" --body "Message body"
python zmail_skill.py send -t user@gmail.com -s "Hello" -b "Message body"

# Reply to a message
python zmail_skill.py reply 123 --body "Thanks for your email!"

# List mailboxes
python zmail_skill.py mailboxes

# Create a new mailbox
python zmail_skill.py create-mailbox agent-2@zergai.com -d "Agent 2"

# Delete a message
python zmail_skill.py delete 123

# Get statistics
python zmail_skill.py stats
```

## Commands

| Command | Description |
|---------|-------------|
| `inbox` | List inbox messages |
| `read ID` | Read a specific message |
| `send` | Send an email |
| `reply ID` | Reply to a message |
| `mailboxes` | List all mailboxes |
| `create-mailbox` | Create a new mailbox |
| `delete ID` | Delete a message |
| `stats` | Get mailbox statistics |
| `health` | Check server health |

## Mailboxes

Each agent can have its own mailbox:
- `fake-idan@zergai.com` - Main AI assistant
- `swarm@zergai.com` - Agent swarm coordinator
- `postmaster@zergai.com` - System mailbox

## Server

The Zmail server runs on Fly.io at `mail.zergai.com`:
- Receives email via SMTP (port 25)
- REST API for reading/sending (HTTPS)
- SQLite storage for messages

Server code: `~/zerg/zmail/`