apple-mail

v2.6.2

Local macOS Apple Mail MCP workflows with 38 tools, IMAP acceleration, account sync, and email management skills.

CodexClaude Code1 Skill1 MCP serverstdio

By isityaelLicense: MIT0 GitHub starsUpdated 6 days ago

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 2 skill or MCP entries
Source updated: Sep 18, 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 and Claude Code

Installs for the current user

codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add apple-mail@agent-plugin-marketplace

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

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/isityael/apple-mail-mcp

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

Plugin files

apple-mail/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/email-management/SKILL.md
└── .mcp.json

Included Skills1

email-managementskills/email-management/SKILL.md

Expert email management assistant for Apple Mail MCP. Use when the user mentions inbox management, email organisation, email triage, inbox zero, organising emails, managing mail folders, email productivity, checking emails, sorting inbox, bulk email moves, IMAP sorting, cross-account moves, recipient search, email workflow optimisation, or managing newsletters. Provides intelligent workflows and best practices for all 38 Apple Mail MCP tools with IMAP-first search acceleration.

MCP servers1

apple-mailstdio

command: /bin/bash
args: ./start_mcp.sh
cwd: .

Plugin manifests2

.codex-plugin/plugin.json

{
  "name": "apple-mail",
  "version": "2.6.2",
  "description": "Local macOS Apple Mail MCP workflows with 38 tools, IMAP acceleration, account sync, and email management skills.",
  "author": {
    "name": "isityael"
  },
  "homepage": "https://github.com/isityael/apple-mail-mcp",
  "repository": "https://github.com/isityael/apple-mail-mcp",
  "license": "MIT",
  "keywords": [
    "apple-mail",
    "email",
    "mcp",
    "macos",
    "productivity"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Apple Mail MCP",
    "shortDescription": "Manage local Apple Mail through MCP tools.",
    "longDescription": "Apple Mail MCP is a local macOS plugin that gives Codex access to Apple Mail workflows through a bundled STDIO MCP server. It supports inbox triage, search, compose, folder management, IMAP-accelerated operations, account sync, analytics, and reusable email management skills. It requires Apple Mail, local Automation permissions, uv, and Python 3.14.",
    "developerName": "isityael",
    "category": "Productivity",
    "capabilities": [
      "MCP",
      "Local",
      "Email",
      "Write"
    ],
    "websiteURL": "https://github.com/isityael/apple-mail-mcp",
    "defaultPrompt": [
      "Summarize my Apple Mail inbox.",
      "Triage unread Apple Mail messages.",
      "Find and organize email by sender."
    ],
    "brandColor": "#2563EB"
  }
}

.claude-plugin/plugin.json

{
  "name": "apple-mail",
  "description": "IMAP-first email management for Apple Mail — search, compose, triage, organise, and analyse email with 38 MCP tools, IMAP acceleration, cross-account moves, account sync, and an expert email management skill",
  "version": "2.6.2",
  "author": {
    "name": "isityael"
  },
  "commands": [
    "./commands/"
  ],
  "mcpServers": {
    "apple-mail": {
      "command": "/bin/bash",
      "args": [
        "${CLAUDE_PLUGIN_ROOT}/start_mcp.sh"
      ]
    }
  }
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[apple-mail on Agent Plugins Marketplace](https://pluginsmp.com/plugins/apple-mail)