Apple Mail

If you're running Claude on macOS and want it to handle your email, this gives it full access to Apple Mail through AppleScript. It can read messages, send replies, search your inbox, manage drafts, and do all the usual mail operations like archiving and marking things read. The output uses delimiters instead of JSON, which is a little old school but keeps things simple for bash parsing. You'll need to grant automation permissions on first run. The nice part is it works with whatever accounts you already have configured in Mail, so there's no OAuth dance or API tokens to manage. Good for automating email workflows or building an AI assistant that actually knows what's in your inbox.

skills.sh installs: 1.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add rbouschery/marketplace --skill apple-mail --agent claude-code

Installs into .claude/skills of the current project.

Files

Apple Mail Skill

This skill provides commands to interact with Apple Mail on macOS via AppleScript.

Available Scripts

All scripts are in the ../../scripts/ directory (relative to this file). Execute them via bash from the plugin root.

Account & Mailbox Management

Script	Purpose	Arguments
`list-accounts.sh`	List all email accounts	none
`list-mailboxes.sh`	List mailboxes/folders	`[account]` (optional)
`get-unread-count.sh`	Get unread email count	`[account] [mailbox]` (optional)

Reading Emails

Script	Purpose	Arguments
`get-emails.sh`	Get recent emails	`[account] [mailbox] [limit] [include_content] [unread_only]`
`get-email-by-id.sh`	Get specific email by ID	`<id> [account] [mailbox] [include_content]`
`search-emails.sh`	Search emails	`<query> [account] [mailbox] [limit]`