Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add sundial-org/awesome-openclaw-skills --skill apple-mail -a claude-code
Open on GitHub

What 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 12345 and 12346.
  • Reply to message 12345 and 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-code

2Manually: put the files in place

~/.claude/skills/apple-mail/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/apple-mail/

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.

From the same set16

remind-me Turn a plain-language request into a one-off or recurring reminder. The skill schedules it with cron and keeps a Markdown log. CX Codex +1 887installs apple-calendar This skill connects an AI agent to Calendar.app on macOS for event search, lookup, creation, editing, deletion, and work across multiple calendars. CX Codex +1 726installs proactive-agent Turns AI agents into proactive assistants that suggest next steps, log decisions before context window compactions, and enforce security checks. CX Codex +1 632installs topic-monitor This skill watches the topics you pick on a schedule, scores each finding for importance, and sends an alert or a weekly digest. CX Codex +1 596installs financial-market-analysis A skill that pulls stock and company data from Yahoo Finance, digests the news and returns a report with a Buy, Hold or Sell rating. CX Codex +1 578installs email-management-expert Guides your coding agent through Apple Mail triage and folder sorting via MCP tools. Helpful when reaching Inbox Zero or finding misplaced threads. CX Codex +1 513installs stock-info-explorer Pulls Yahoo Finance data through yfinance, computes indicators on your machine and saves a PNG chart. Handy when you want a quick read on a ticker without leaving the terminal. CX Codex +1 508installs stock-evaluator-v3 Skill for full stock evaluation before you buy: applies eight legendary investor frameworks, runs technical and fundamental checks, builds a 60+ metric dashboard, and gives a clear buy, hold, or sell call. CX Codex +1 374installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor