# apple-mail

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 installs
- Author: rbouschery
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rbouschery/marketplace/tree/HEAD/plugins/apple-mail/skills/apple-mail/SKILL.md
- Updated: 2026-01-22
- HTML: https://affpapa.org/en/nevibecode/skills/apple-mail

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add rbouschery/marketplace --skill apple-mail -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add rbouschery/marketplace --skill apple-mail -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add rbouschery/marketplace --skill apple-mail -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rbouschery/marketplace apple-mail
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add rbouschery/marketplace --skill apple-mail -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/rbouschery/marketplace --path plugins/apple-mail/skills/apple-mail
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add rbouschery/marketplace --skill apple-mail -a opencode
```

### 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/rbouschery/marketplace/tree/HEAD/plugins/apple-mail/skills/apple-mail/SKILL.md

## When to use it
- 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
- 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

## Similar
- [email-management-expert](https://affpapa.org/en/nevibecode/skills/email-management-expert.md) — skill · 513 installs
- [imessage](https://affpapa.org/en/nevibecode/plugins/imessage.md) — plugin · ★ 44635
- [apple-notes](https://affpapa.org/en/nevibecode/skills/hermes-agent-apple-notes.md) — skill · 381 installs
- [apple-reminders](https://affpapa.org/en/nevibecode/skills/hermes-agent-apple-reminders.md) — skill · 367 installs
- [capture-screen](https://affpapa.org/en/nevibecode/skills/capture-screen.md) — skill · 1000 installs
- [Apple Shortcuts Integration](https://affpapa.org/en/nevibecode/skills/apple-shortcuts-integration.md) — skill · 4700 installs

---
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