ModelsAtlas
Explore
Atlas / MCP servers / sweetrb / apple-mail-mcp

apple-mail-mcpCAUTION

mcp/sweetrb/apple-mail-mcp
MCP server by sweetrb · apple · apple mail · applescript · Audited 2026-10-12
⚑ Report / re-scanSource ↗

MCP server for Apple Mail - read, search, send, and manage emails via Claude and other AI assistants

Verdict
CAUTION
Grade
B
Trust score
82 /100
Exposed tools
2 2r · 0w · 0d
Transport
stdio
License
MIT
Stars
91
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

A Model Context Protocol (MCP) server that enables AI assistants like Claude to read, send, search, and manage emails in Apple Mail on macOS.

[](https://www.npmjs.com/package/apple-mail-mcp) [](https://www.npmjs.com/package/apple-mail-mcp) [](https://www.npmjs.com/package/apple-mail-mcp) [](https://github.com/sweetrb/apple-mail-mcp/actions/workflows/ci.yml) [](https://scorecard.dev/viewer/?uri=github.com/sweetrb/apple-mail-mcp) [](https://www.apple.com/macos/) [](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io)

Note: This is the npm/Node.js package — install with npx or npm. There is an unrelated Python project of the same name on PyPI (`imdinu/apple-mail-mcp`) installed via pipx/uvx. If you're using uvx and seeing a cyclopts dependency error, you're looking for that project, not this one.

What is This?

This server acts as a bridge between AI assistants and Apple Mail. Once configured, you can ask Claude (or any MCP-compatible AI) to:

  • "Check my inbox for unread messages"
  • "Find emails from john@
Read from source at commit 04aef73ae695OBSERVED · 2026-10-12
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add apple-mail-mcp --env GREENMAIL_PASS=${GREENMAIL_PASS} -- npx -y [email protected]
claude-desktop
{
  "mcpServers": {
    "apple-mail-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GREENMAIL_PASS": "${GREENMAIL_PASS}"
      }
    }
  }
}
03

Exposed tools (2)

2 read · 0 write · 0 destructive.

ToolRiskDescription
fastread
slowread
04

Trust audit

CAUTIONgrade B · trust 82/100 Install with care. The audit found things worth knowing before you trust its output.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeWARN
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (1 observation(s))
Network
declared (1 observation(s))
Shell
declared (2 observation(s))
Dependencies
not all pinned
Secrets in source
found

Findings (25)

MEDIUMHard-coded secrets · secret.generic · CWE-798, CWE-321
src/services/imapClient.ts:59
password: "APPLE_MAIL_MCP_IMAP_PASSWORD",
MEDIUMHard-coded secrets · secret.generic · CWE-798, CWE-321
src/services/smtpMailer.ts:148
password: "APPLE_MAIL_MCP_SMTP_PASSWORD",
LOWInventory / provenance · inv.binary · CWE-1104
src/services/hardening.test.ts
hardening.test.ts
Why it matters. a compiled or binary member cannot be reviewed from source
Fix. ship source, or explain the binary in the README
LOWFilesystem / path · fs.system_paths · CWE-22, CWE-59
src/services/appleMailManager.attachmentPath.test.ts:53
symlinkSync("/etc/hosts", join(root, "hosts"));
LOWFilesystem / path · fs.system_paths · CWE-22, CWE-59
src/services/appleMailManager.attachmentPath.test.ts:71
const file = "/etc/hosts";
LOWFilesystem / path · fs.system_paths · CWE-22, CWE-59
src/services/appleMailManager.replyAttachments.test.ts:124
expect(() => mgr.replyToMessage("42", "body", false, false, ["/etc/hosts"])).toThrow(
LOWFilesystem / path · fs.system_paths · CWE-22, CWE-59
src/services/smtpMailer.test.ts:298
const file = "/etc/hosts";
LOWFilesystem / path · fs.system_paths · CWE-22, CWE-59
src/tools/compose.issue267.test.ts:192
const outside = "/etc/hosts";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/security.test.ts:114
expect(isInvalidAttachmentName("../../etc/passwd")).toBe(true);
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/security.test.ts:153
expect(isAllowedPath("/tmp/../../etc")).toBe(false);
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
test/integration.test.ts:133
const result = mgr.saveAttachment(BOGUS_ID, "test.pdf", "/tmp/../../etc");
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
test/integration.test.ts:138
const result = mgr.saveAttachment(BOGUS_ID, "../../etc/passwd", "/tmp");
LOWNetwork egress · net.tls_off · CWE-200, CWE-319
test/imap.integration.test.ts:61
tls: { rejectUnauthorized: false },
Why it matters. certificate verification is disabled
Fix. leave verification on
LOWNetwork egress · net.tls_off · CWE-200, CWE-319
test/imap.integration.test.ts:72
tls: { rejectUnauthorized: false },
Why it matters. certificate verification is disabled
Fix. leave verification on
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@modelcontextprotocol/sdk, imapflow, nodemailer, zod, @eslint/js, @types/node, @types/nodemailer, @typescript-eslint/eslint-plugin
Why it matters. 21 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
CHANGELOG.md:2326
- **"Not configured" errors now end with the absolute setup-guide URL + a `doctor` hint.** `SMTP transport is not configured...` / `No SMTP password found...` (`smtpMailer`), `IMAP not configured...`
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
CHANGELOG.md:2627
- **Opt-in IMAP backend for `search-messages` / `list-messages` (Phase 1)** — when an account is configured for IMAP, these two read paths run a **server-side IMAP search** (via `imapflow`) instead of
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
CHANGELOG.md:2698
- **`send-email` SMTP transport — bypasses the macOS 15+ `<blockquote>` wrapping** — outgoing messages built through Mail.app's AppleScript path get wrapped in `<blockquote type="cite">` (Apple-Mail-U
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
docs/THREAT-MODEL.md:127
| TM-007    | Network attacker or misconfigured provider   | SMTP/IMAP configured without implicit TLS; endpoint can omit STARTTLS             | Cause or exploit plaintext continuation
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
INFOInventory / provenance · inv.oversize · CWE-1104
build/cli.js
build/cli.js
Why it matters. 2494211 bytes not read
INFOInventory / provenance · inv.oversize · CWE-1104
build/index.js
build/index.js
Why it matters. 3681120 bytes not read
INFOPrompt injection · prompt.conditional_escalation · CWE-94, CWE-1427
.antigravity-plugin/skills/apple-mail/SKILL.md:8
This skill enables you to manage Apple Mail on macOS through natural language. Use it whenever the user mentions email, wants to send messages, or needs to read, search, or organize their inbox.
INFOPrompt injection · prompt.conditional_escalation · CWE-94, CWE-1427
codex/skills/apple-mail/SKILL.md:8
This skill enables you to manage Apple Mail on macOS through natural language. Use it whenever the user mentions email, wants to send messages, or needs to read, search, or organize their inbox.
INFOPrompt injection · prompt.conditional_escalation · CWE-94, CWE-1427
skills/apple-mail/SKILL.md:8
This skill enables you to manage Apple Mail on macOS through natural language. Use it whenever the user mentions email, wants to send messages, or needs to read, search, or organize their inbox.
INFOPrompt injection · prompt.credential_read · CWE-94, CWE-1427
CHANGELOG.md:2413
- Documented two previously read-but-undocumented environment variables in the README:
Why it matters. asks the agent to read credentials

Gates applied: no_behavioural_pass.

Audited 2026-10-12 · audit v0.4.1 · source sha 04aef73ae695full audit observations/trust-audit/mcp-server/sweetrb__apple-mail-mcp.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-1204aef73ae695CAUTIONB82first audit
06

Questions

What is the apple-mail-mcp MCP server?

MCP server for Apple Mail - read, search, send, and manage emails via Claude and other AI assistants

What tools does apple-mail-mcp expose?

2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is apple-mail-mcp safe to connect to an agent?

With care. The audit graded it B (82/100) and found 25 things worth knowing before you trust this server, listed below with the exact line each was found on.

What credentials does apple-mail-mcp need?

It reads GREENMAIL_PASS from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does apple-mail-mcp run?

It speaks stdio, so it runs as a local process your client starts. It is published on npm as apple-mail-mcp at 2.20.9.

How current is this page?

The grade is for one exact copy of the source (04aef73ae695), read on 2026-10-12. The repository is watched and re-audited when it changes.

Advertisement