# Email Manager

> Read, search, send, and manage email via IMAP/SMTP or API (Gmail, Outlook).

- **Type:** Skill
- **Install:** `agentstack add skill-jansenanalytics-claudex-email-manager`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [JansenAnalytics](https://agentstack.voostack.com/s/jansenanalytics)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [JansenAnalytics](https://github.com/JansenAnalytics)
- **Source:** https://github.com/JansenAnalytics/claudex/tree/main/skills/email-manager

## Install

```sh
agentstack add skill-jansenanalytics-claudex-email-manager
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# email-manager

Read, search, send, and manage email via IMAP/SMTP or API (Gmail, Outlook).

## When to Use

- Checking inbox or unread messages
- Searching emails by sender, subject, date, or content
- Sending or composing email messages
- Managing folders (move, delete, archive)
- Setting up email automation or configuring clients programmatically

## Scripts

### `scripts/imap-reader.py`

Read inbox via IMAP. Connects, fetches recent messages, displays subject/from/date.

```bash
# List 10 most recent emails
python3 scripts/imap-reader.py --host imap.gmail.com --user you@gmail.com --password "app-password" --count 10

# Search by sender
python3 scripts/imap-reader.py --host imap.gmail.com --user you@gmail.com --password "app-password" --search "FROM someone@example.com"

# Dry-run (no server connection, shows sample output)
python3 scripts/imap-reader.py --dry-run
```

**Environment variables:** `IMAP_HOST`, `IMAP_USER`, `IMAP_PASS` (alternative to flags).

### `scripts/email-sender.py`

Send email via SMTP (supports Gmail, Outlook, custom SMTP).

```bash
# Send an email
python3 scripts/email-sender.py --host smtp.gmail.com --port 587 --user you@gmail.com --password "app-password" \
  --to recipient@example.com --subject "Hello" --body "Message body"

# Dry-run (compose without sending)
python3 scripts/email-sender.py --dry-run --to recipient@example.com --subject "Test" --body "Draft"
```

### `scripts/email-composer.py`

Compose and format emails (plain text or HTML). Always dry-run — outputs the composed message without sending.

```bash
# Compose a plain text email
python3 scripts/email-composer.py --to user@example.com --subject "Meeting" --body "Let's meet tomorrow at 10."

# Compose HTML email
python3 scripts/email-composer.py --to user@example.com --subject "Report" --html --body "Q4 ReportSee attached."
```

## References

- `references/imap-commands.md` — Common IMAP commands and search syntax
- `references/smtp-setup.md` — SMTP configuration for Gmail, Outlook, custom servers
- `references/gmail-api-quickstart.md` — Gmail API setup with OAuth2

## Requirements

- Python 3.8+
- No pip dependencies (uses stdlib: `imaplib`, `smtplib`, `email`)
- For Gmail: enable "App Passwords" or use OAuth2 via Gmail API

## Security Notes

- Never hardcode passwords in scripts; use env vars or credential files
- Gmail requires App Passwords (2FA enabled) or OAuth2
- IMAP/SMTP connections use TLS/SSL by default

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [JansenAnalytics](https://github.com/JansenAnalytics)
- **Source:** [JansenAnalytics/claudex](https://github.com/JansenAnalytics/claudex)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jansenanalytics-claudex-email-manager
- Seller: https://agentstack.voostack.com/s/jansenanalytics
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.