maxxing-mail — Claude Code skill: email and installation
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.
no license ★ 285 updated 2026-11-17
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a claude-codeWhat maxxing-mail 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.
What it helps with
- 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 for the agent
- Find unread messages in the mailbox and show mail from
[email protected]. - Draft a reply to the email with UID
123. - Start the agent on new mail from
*@stripe.comand require approval before sending.
How to install maxxing-mail
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a claude-code2Manually: put the files in place
~/.claude/skills/maxxing-mail/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/maxxing-mail/
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a codex2Manually: put the files in place
.agents/skills/maxxing-mail/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a cursor2Manually: put the files in place
.cursor/skills/maxxing-mail/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makushingu/harness-maxxing skills/maxxing-mail2Manually: put the files in place
.github/skills/maxxing-mail/SKILL.md1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-mail -a gemini-cli2Platform CLI
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/maxxing-mailManually: put the files in place
.devin/skills/maxxing-mail/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about maxxing-mail
How do I install maxxing-mail in Claude Code?
Run npx skills add makushingu/harness-maxxing --skill maxxing-mail -a claude-code. The skill file will be at ~/.claude/skills/maxxing-mail/SKILL.md.
What does maxxing-mail do?
It lets an agent search, read, and sort email through maxxing mail, create drafts, and respond to new messages according to mailbox settings.
What does maxxing-mail need to run?
It needs maxxing mail and a configured IMAP/SMTP mailbox. An agent in default permission mode also needs Bash(maxxing mail:*) in its allowed tools.