apple-mail — Claude Code skill for Apple Mail on macOS
This skill gives your agent a way into Apple Mail on macOS: read, search, send and tidy up messages. Handy when your mail lives in the desktop app.
npx skills add rbouschery/marketplace --skill apple-mail -a claude-codeWhat apple-mail does
Under the hood it is a set of bash scripts that drive Apple Mail through AppleScript. They sit in ../../scripts/ relative to the skill file and run from the plugin root. The scripts split into account and mailbox handling, reading, composing, and message management.
list-accounts.sh and list-mailboxes.sh cover accounts and folders, get-unread-count.sh counts unread mail. Reading goes through get-emails.sh, get-email-by-id.sh and search-emails.sh. Sending uses send-email.sh; create-draft.sh and create-reply-draft.sh build drafts, and send-draft.sh fires off the front-most one. Archive, delete and read-state changes live in archive-email.sh, delete-email.sh, mark-read.sh and mark-unread.sh.
Output is delimited: <<>> between fields in a record, ||| between records, and errors start with ERROR:. Pass empty optional arguments as "" and comma-separate multiple recipients. This only works on macOS with Apple Mail configured and at least one account. The first run triggers macOS automation permission prompts — decline them and the scripts fail, so check your privacy settings before you rely on it.
What it helps with
- list email accounts and mailboxes in Apple Mail
- pull recent INBOX messages with their content
- find a message by query and read it
- send a message with cc and bcc
- mark a message as read or archive it
Example prompts for the agent
- show the last 10 unread emails from INBOX with content
- search emails for meeting notes and show the first 20
- create a reply draft to message 12345 saying thanks for the message
How to install apple-mail
1Skills CLI (Vercel)
npx skills add rbouschery/marketplace --skill apple-mail -a claude-code2Manually: put the files in place
~/.claude/skills/apple-mail/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/apple-mail/
1Skills CLI (Vercel)
npx skills add rbouschery/marketplace --skill apple-mail -a codex2Manually: put the files in place
.agents/skills/apple-mail/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rbouschery/marketplace --skill apple-mail -a cursor2Manually: put the files in place
.cursor/skills/apple-mail/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rbouschery/marketplace apple-mail2Manually: put the files in place
.github/skills/apple-mail/SKILL.md1Skills CLI (Vercel)
npx skills add rbouschery/marketplace --skill apple-mail -a gemini-cli2Platform CLI
gemini skills install https://github.com/rbouschery/marketplace --path plugins/apple-mail/skills/apple-mailManually: put the files in place
.devin/skills/apple-mail/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rbouschery/marketplace --skill apple-mail -a opencodeClaude.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 apple-mail
How do I install apple-mail in Claude?
Run npx skills add rbouschery/marketplace --skill apple-mail -a claude-code. The skill lands at ~/.claude/skills/apple-mail/SKILL.md.
What does apple-mail do?
It gives the agent commands for Apple Mail on macOS: listing accounts and mailboxes, reading and searching messages, sending mail, creating drafts, archiving and toggling read state.
What does the skill need to work?
macOS with Apple Mail set up and at least one account configured. The first run asks for automation permission.
