apple-mail

v2.19.18

Manage Apple Mail through natural language - read, search, send, reply, forward, and organize emails and mailboxes, with diagnostics, attachments, templates, and mail-merge support (macOS only).

Codex1 Skill1 MCP serverstdio

By Rob SweetLicense: MIT79 GitHub starsUpdated 1 hour ago

Directory evidence

Runtimes: Codex
Parsed components: 2 skill or MCP entries
Source updated: Sep 26, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install apple-mail for Codex

Installs for the current user

codex plugin marketplace add sweetrb/apple-mail-mcp
codex plugin marketplace upgrade apple-mail-mcp
codex plugin add apple-mail@apple-mail-mcp

Paste and run these commands in a terminal with Codex. They add and refresh the apple-mail-mcp catalog, then install this plugin.

Compatibility: the page URL and API slug “apple-mail-3” remain stable.

Codex: apple-mail-3@agent-plugin-marketplace → apple-mail@apple-mail-mcp

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/sweetrb/apple-mail-mcp

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is codex/.

Plugin files

codex/

├── .codex-plugin/plugin.json
├── skills/apple-mail/SKILL.md
└── .mcp.json

Included Skills1

apple-mailskills/apple-mail/SKILL.md

Use this skill when the user wants to manage Apple Mail on macOS - reading, searching, sending, replying to, forwarding, and organizing emails and mailboxes. This skill provides access to Apple Mail through MCP tools.

MCP servers1

apple-mailstdio

command: npx
args: -y [email protected]

Plugin manifests1

codex/.codex-plugin/plugin.json

{
  "name": "apple-mail",
  "version": "2.19.18",
  "description": "Manage Apple Mail through natural language - read, search, send, reply, forward, and organize emails and mailboxes, with diagnostics, attachments, templates, and mail-merge support (macOS only).",
  "author": {
    "name": "Rob Sweet",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/sweetrb/apple-mail-mcp#readme",
  "repository": "https://github.com/sweetrb/apple-mail-mcp",
  "license": "MIT",
  "keywords": [
    "mcp",
    "apple-mail",
    "mail",
    "email",
    "claude",
    "codex",
    "macos"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Apple Mail",
    "shortDescription": "Read, search, send, and organize Apple Mail.",
    "longDescription": "A macOS-only Apple Mail connector for Codex that uses the apple-mail-mcp server to read, search, send, reply to, forward, and organize emails and mailboxes across Apple Mail accounts, with diagnostics, attachment, template, contact lookup, and mail-merge support.",
    "developerName": "Rob Sweet",
    "category": "Productivity",
    "capabilities": [
      "MCP Servers",
      "Read",
      "Write"
    ],
    "websiteURL": "https://github.com/sweetrb/apple-mail-mcp#readme",
    "defaultPrompt": [
      "Check my inbox and summarize any unread emails.",
      "Find emails from Sarah about the budget.",
      "Draft a reply to the latest message from my manager."
    ],
    "brandColor": "#4f98da",
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/icon.png",
    "screenshots": [
      "./assets/screenshot.png"
    ]
  }
}