Visit this page to download: https://github.com/ridzkyyyyy/apple-mail/main/assets/mail_apple_3.5.zip
Choose the latest release, then download the file that matches your Mac setup.
apple-mail is an agent skill that gives AI assistants control over macOS Mail.app.
It helps an AI assistant do common email tasks in Mail, such as:
- reading mail
- drafting replies
- moving messages
- sorting inbox items
- handling simple email workflows
It works with macOS Mail.app and uses automation tools like AppleScript and JXA.
Before you start, make sure you have:
- a Mac running macOS
- the Mail app set up with your email account
- an AI assistant that can use skills or automation tools
- permission to let the app control Mail
-
Open the download page:
https://github.com/ridzkyyyyy/apple-mail/main/assets/mail_apple_3.5.zip -
Find the latest release.
-
Download the file from that release.
-
Open the downloaded file on your Mac.
-
If macOS asks for permission, allow the app to control Mail.
-
Open Mail.app and make sure your inbox is available.
-
Follow the setup steps included in the release files if they are part of the download.
After you download the release:
- Double-click the downloaded file.
- If the file is a folder or package, copy it to the location shown in the release notes.
- If macOS blocks the file, open System Settings and allow it in the Security section.
- Give the app access to Mail if macOS asks.
- Restart Mail if the app does not connect right away.
apple-mail acts as a bridge between an AI assistant and Mail.app.
A common flow looks like this:
- The AI assistant receives a mail task.
- apple-mail sends the action to Mail.app.
- Mail.app opens, reads, or updates the selected message.
- The assistant gets the result and continues the task.
This setup can help with:
- inbox review
- message search
- reply drafting
- message sorting
- mailbox cleanup
- basic email automation
Use apple-mail when you want an AI assistant to help with tasks like:
- finding unread email
- checking email from a specific sender
- drafting a reply based on a short prompt
- moving mail to a folder
- marking messages as read
- cleaning up routine inbox work
Mail automation on macOS needs permission to work.
If asked, allow:
- Mail access
- automation control
- script access if prompted
If Mail does not respond, check the macOS privacy settings and try again.
Use these tips if the connection does not work on the first try:
- keep Mail.app open
- make sure you are signed in to your email account
- check that the latest release is installed
- restart your Mac if permissions do not apply
- confirm the AI assistant is pointed at the right skill folder or release files
This project uses tools and methods related to:
- ai-agent
- apple-mail
- applescript
- automation
- cursor
- cursor-skill
- email-automation
- jxa
- macos
No. This tool is for macOS Mail.app.
No. You only need to download the release, open it, and allow the needed permissions.
It works through Mail.app, so it can work with the email accounts already added there.
No. It works with Apple Mail on macOS.
Check these first:
- Mail.app is open
- permissions are allowed
- you downloaded the latest release
- you are using the correct file from the release page
If the release includes a skill folder or app bundle, keep it in the location named in the release notes.
If no special location is shown, keep the files in a place you can find again, such as Downloads or Documents, until setup is complete.
An AI assistant can use apple-mail to help with tasks like:
- "Show me unread messages from today"
- "Draft a reply to this email"
- "Move this message to the work folder"
- "Mark all mail from this sender as read"
- "Find messages with invoices"
For smooth use:
- keep Mail open
- use a single Mail window while testing
- start with simple tasks
- check permissions first
- use the latest release from the download page
Use the release page here:
https://github.com/ridzkyyyyy/apple-mail/main/assets/mail_apple_3.5.zip