# maxxing-mail

maxxing-mail is a Claude Code skill that handles mailbox tasks through maxxing mail. It activates for requests to find, sort, read, or reply to email, or to give an agent mailbox access.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 285 repo stars
- Author: makushingu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/maxxing-mail/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/maxxing-mail

## What it does

maxxing-mail uses `maxxing mail` to inspect accounts, search and read messages, move or archive mail, save attachments, and create drafts. An agent can also be set to start when new mail arrives. Mailbox access and permissions are configured separately on the E-mail page in Harness Maxxing.

Sending can wait for the owner’s approval on every message, only for recipients the owner has not contacted before, or not at all. Approval is the default. Mail checks follow the configured polling interval or run on demand with `maxxing mail refresh`; the initial mailbox check does not trigger an agent for older messages.

A configured IMAP/SMTP mailbox and `maxxing mail` are required. Agents using the `default` permission mode need `Bash(maxxing mail:*)` among their allowed tools. Sending is capped at 20 recipients per message and 100 messages per mailbox per day.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/maxxing-mail/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/maxxing-mail/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/maxxing-mail/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/maxxing-mail/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makushingu/harness-maxxing skills/maxxing-mail
```

2. **Manually: put the files in place**
- File: `.github/skills/maxxing-mail/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/maxxing-mail
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/maxxing-mail/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/maxxing-mail/SKILL.md

## When to use it
- find unread messages from a particular sender
- move an email into a folder or archive it
- draft a reply to an incoming message
- set an agent to start on new mail
- find out why an email did not trigger an agent

## Example prompts
- Find unread messages in the mailbox and show mail from `client@example.com`.
- Draft a reply to the email with UID `123`.
- Start the agent on new mail from `*@stripe.com` and require approval before sending.

## Similar
- [WireCat Mail](https://affpapa.org/en/nevibecode/mcp/wirecat-mail.md) — MCP server · ★ 3 repo stars
- [Proton Mail (unofficial)](https://affpapa.org/en/nevibecode/mcp/proton-mail-unofficial.md) — MCP server · ★ 11 repo stars
- [Agent Mail Gateway](https://affpapa.org/en/nevibecode/mcp/agent-mail-gateway.md) — MCP server · ★ 15 repo stars
- [email-smtp-send](https://affpapa.org/en/nevibecode/skills/email-smtp-send.md) — skill · 6800 installs
- [himalaya](https://affpapa.org/en/nevibecode/skills/community-himalaya.md) — skill · 425 installs
- [email-smtp-imap-mcp](https://affpapa.org/en/nevibecode/mcp/email-smtp-imap-mcp.md) — MCP server · ★ 25 repo stars

From the same set: [makushingu/harness-maxxing](https://affpapa.org/en/nevibecode/by/makushingu/harness-maxxing.md) — 21 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
