New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started

@honeycrisp/mail

Package Overview
Dependencies
Maintainers
1
Versions
3
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@honeycrisp/mail

Apple Mail over MCP, built on the governed framework: reads free, drafts write-safe, no send tool at all

latest
Source
npmnpm
Version
0.1.2
Version published
Maintainers
1
Created
Source

honeycrisp-mail

Apple Mail over MCP, built on the governed framework. Reads are free, drafts are write-safe, mutations are gated behind a native macOS approval dialog — and there is no send tool at all.

The draft-first doctrine

The outward path is mail_create_draft → you open Mail.app → you hit send. The gate that was never built cannot be bypassed: this server is structurally unable to send email, and a test in test/doctrine.test.ts fails if a tool with "send" in its name ever appears. Worst case is a bad draft, not a bad send.

Tools

ToolModeNotes
mail_list_accountsreadaccounts, addresses, mailboxes
mail_searchreadheader search (subject/sender/date) — fast, index-backed
mail_search_fulltextreadbody text via Spotlight — requires Full Disk Access (see below)
mail_readreadfull message by Message-ID; body arrives inside the injection fence
mail_threadreadconversation by normalized subject across inbox + sent
mail_create_draftwrite-safenew draft or reply (replyToMessageId); account required; provenance footer; body redacted from the audit log
mail_markwrite-gatedread/flagged status; native undo (previous state captured before the write)
mail_movewrite-gatedmove between mailboxes; native undo (source mailbox captured first)

Everything inherits the framework contract: dry-run by default for gated tools, per-action human approval out-of-band from the model, an audit row for every execution path, injection fencing on message content, provenance on drafts.

Permissions (two tiers, least privilege)

  • Automation (prompted on first use): everything except full-text search.
  • Full Disk Access (optional, opt-in via System Settings): unlocks mail_search_fulltext. Without it the tool refuses with instructions — deliberately, because Spotlight silently returns zero mail results for processes without this permission, and a silent empty is worse than an honest refusal.

Notes

  • account is required for drafts — the writing identity is never guessed.
  • Some iCloud accounts expose no email addresses to scripting; drafting from one fails with instructions rather than producing a sender-less draft.
  • The first call after a cold Mail.app launch can be slow; subsequent calls are ~1s. Timeouts say so instead of failing cryptically.

Keywords

mcp

FAQs

Package last updated on 01 Aug 2026

Related posts