apple-mail

Automate Apple Mail workflows using AppleScript and osascript.

1|Updated Nov 15, 2022
One-click install
npx skills add https://github.com/BfdCampos/dotfiles --skill apple-mail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apple-mail
Source: https://github.com/BfdCampos/dotfiles/tree/main/claude/skills/apple-mail
Command: npx skills add https://github.com/BfdCampos/dotfiles --skill apple-mail

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates Apple Mail automation reduces repetitive tasks by leveraging AppleScript to read emails, compose and send messages, and organize mailboxes, freeing time for higher-value work.

Core Features & Use Cases

  • Read and inspect emails across accounts using AppleScript to enumerate accounts and mailboxes.
  • Send and reply to messages while preserving threading and subject lines.
  • Manage mailboxes, search by subject or sender, move or delete messages to organize your inbox.

Quick Start

Run the provided AppleScript examples to automate a simple read-and-reply workflow in Apple Mail.

Frequently Asked Questions about apple-mail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate reading and organizing emails in Apple Mail with AppleScript?

You can automate reading and organizing emails in Apple Mail by running AppleScript commands via osascript. This Skill provides practical scripts to enumerate accounts, search mailboxes by sender or subject, and move or delete messages to manage your inbox.

Can I send and reply to messages in macOS Mail without losing threading?

Yes, sending and replying to messages in macOS Mail can be scripted with AppleScript while preserving threading and subject lines. The Skill demonstrates safe, repeatable patterns to compose and send messages across your configured accounts.

What tasks can I automate with osascript in macOS Mail?

With osascript in macOS Mail, you can automate reading emails, searching by subject or sender, managing mailboxes, and moving or deleting messages. The Skill details practical AppleScript commands for these routine tasks.

Do I need any extra dependencies to script Apple Mail workflows?

No extra dependencies are required to script Apple Mail workflows. The Skill relies on built-in macOS AppleScript and osascript capabilities to handle accounts, mailboxes, and messages.

What is the best way to search for emails across multiple accounts in Apple Mail?

The best way to search emails across multiple accounts in Apple Mail is using AppleScript to enumerate accounts and mailboxes. This Skill provides patterns to safely search mail by subject or sender and manage the results.

Are there limitations to automating mailbox management with AppleScript?

Automating mailbox management with AppleScript is limited to what the macOS Mail AppleScript dictionary exposes. The Skill focuses on safe, repeatable scripts for moving, deleting, and organizing messages within those boundaries.