apple-mail · sundial-org — Claude Code skill: email actions and install
This skill connects an agent to Apple Mail.app to search, read, send, and manage messages. Use it to handle email tasks through your coding agent.
npx skills add sundial-org/awesome-openclaw-skills --skill apple-mail -a claude-codeWhat apple-mail does
The skill works with Apple Mail.app through AppleScript and SQLite. It can search for messages, read them, send new email, reply, delete messages, and change read status. Several message IDs can be handled in one call. Fast search queries a temporary copy of the database, so Mail.app can stay open.
It requires macOS, sqlite3, and a running Mail.app. List and search scripts use cached data, so run scripts/mail-refresh.sh before looking for the latest messages. Gmail folders such as Sent Mail need the [Gmail]/ prefix: use [Gmail]/Sent Mail as the mailbox name.
Check the recipient before sending; the skill’s instructions call this out. Mail.app also adds a blank line at the start of sent messages, and the script cannot bypass that behavior.
What it helps with
- find messages with a search query
- read messages by ID
- send an email or reply to a message
- delete several messages by ID
- mark messages as read or unread
Example prompts for the agent
- Find emails matching “invoice” and show the recent results.
- Read the messages with IDs
12345and12346. - Reply to message
12345and confirm that you received it.
How to install apple-mail
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --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 sundial-org/awesome-openclaw-skills --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 sundial-org/awesome-openclaw-skills --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 sundial-org/awesome-openclaw-skills apple-mail2Manually: put the files in place
.github/skills/apple-mail/SKILL.md1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill apple-mail -a gemini-cli2Platform CLI
gemini skills install https://github.com/sundial-org/awesome-openclaw-skills --path 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 sundial-org/awesome-openclaw-skills --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 Code?
Run npx skills add sundial-org/awesome-openclaw-skills --skill apple-mail -a claude-code. The skill file is placed at ~/.claude/skills/apple-mail/SKILL.md.
What does apple-mail do?
It lets an agent search and read Apple Mail.app messages, send email and replies, and change message status.
What does apple-mail need to run?
It needs macOS, sqlite3, and Mail.app open. Run scripts/mail-refresh.sh before listing messages when you need current data.
Similar skills
SKILL.md skills catalog →apple-mail by other authors comes first.