{"_id":"@egorkurito/apple-mail-mcp","name":"@egorkurito/apple-mail-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@egorkurito/apple-mail-mcp","version":"1.0.0","description":"MCP server for Apple Mail via NSAppleScript","type":"module","main":"build/index.js","bin":{"apple-mail-mcp":"build/index.js"},"scripts":{"build":"tsc","start":"node build/index.js","prepare":"npm run build","postinstall":"node scripts/postinstall.js"},"keywords":["mcp","apple-mail","macos","email","model-context-protocol","claude","applescript"],"repository":{"type":"git","url":"git+https://github.com/egorkurito/apple-mail-mcp.git"},"homepage":"https://github.com/egorkurito/apple-mail-mcp#readme","bugs":{"url":"https://github.com/egorkurito/apple-mail-mcp/issues"},"author":{"name":"egorkurito"},"license":"MIT","engines":{"node":">=18"},"os":["darwin"],"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","execa":"^9.5.2","zod":"^3.24.2"},"devDependencies":{"@types/node":"^22.13.1","typescript":"^5.7.3"},"gitHead":"8e2443b37855528e8a9492f37383de0d81d0d2fc","types":"./build/index.d.ts","_id":"@egorkurito/apple-mail-mcp@1.0.0","_nodeVersion":"25.6.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-/6KbteN74x+DPiTpXpS34Uc3stFRi4y/9SDfyUORzZ2CrYkQhwD6QXuW71X9uYKy36FMQfwo8YIfa6MLc9PpaA==","shasum":"ea6e952ab9a9db19b9554e3c74a4929367cc24b3","tarball":"https://registry.npmjs.org/@egorkurito/apple-mail-mcp/-/apple-mail-mcp-1.0.0.tgz","fileCount":20,"unpackedSize":69128,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEMCIGPDcQANc5j1pxZRAzILZcWZCpx0d57wMstLNMtq8o8pAh9OYIQEycdL1j8gH1QuvZVGp/qRKm9rdTXNdvZyH+mo"}]},"_npmUser":{"name":"egorkurito","email":"ekurito@gmail.com"},"directories":{},"maintainers":[{"name":"egorkurito","email":"ekurito@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/apple-mail-mcp_1.0.0_1770464078690_0.9330246272880889"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-07T11:34:38.581Z","1.0.0":"2026-02-07T11:34:38.856Z","modified":"2026-02-07T11:34:39.112Z"},"maintainers":[{"name":"egorkurito","email":"ekurito@gmail.com"}],"description":"MCP server for Apple Mail via NSAppleScript","homepage":"https://github.com/egorkurito/apple-mail-mcp#readme","keywords":["mcp","apple-mail","macos","email","model-context-protocol","claude","applescript"],"repository":{"type":"git","url":"git+https://github.com/egorkurito/apple-mail-mcp.git"},"author":{"name":"egorkurito"},"bugs":{"url":"https://github.com/egorkurito/apple-mail-mcp/issues"},"license":"MIT","readme":"# @egorkurito/apple-mail-mcp\n\nMCP server for Apple Mail on macOS. Provides read-only access to mail accounts, mailboxes, and messages through the [Model Context Protocol](https://modelcontextprotocol.io).\n\nUses a two-layer architecture: TypeScript MCP server communicates with a Swift CLI binary (`mail-bridge`) that interfaces with Mail.app via NSAppleScript.\n\n## Requirements\n\n- **macOS 13+** (Ventura or later)\n- **Node.js 18+**\n- **Xcode Command Line Tools** (`xcode-select --install`)\n- **Mail.app** configured with at least one account\n\n## Installation\n\n### Claude Desktop / Claude Code\n\nAdd to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"apple-mail\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@egorkurito/apple-mail-mcp\"]\n    }\n  }\n}\n```\n\n### Global install\n\n```bash\nnpm install -g @egorkurito/apple-mail-mcp\n```\n\nThen configure MCP:\n\n```json\n{\n  \"mcpServers\": {\n    \"apple-mail\": {\n      \"command\": \"apple-mail-mcp\"\n    }\n  }\n}\n```\n\n### Manual (with custom binary path)\n\n```json\n{\n  \"mcpServers\": {\n    \"apple-mail\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/build/index.js\"],\n      \"env\": {\n        \"MAIL_BRIDGE_BIN\": \"/path/to/swift/.build/release/mail-bridge\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_mail_accounts` | List all mail accounts (name, email, type, enabled) |\n| `get_mailboxes` | List mailboxes with unread/message counts and nested folders |\n| `get_messages` | Get message headers from a mailbox with pagination (newest first) |\n| `get_message` | Get full message content including body, recipients, and attachments |\n| `get_unread_messages` | List unread messages across all accounts or filtered by account/mailbox |\n| `search_mail` | Search messages by subject or sender |\n\n## Permissions\n\nOn first run, macOS will ask you to grant automation permissions. Go to:\n\n**System Settings > Privacy & Security > Automation** and allow `mail-bridge` (or Terminal/iTerm) to control **Mail.app**.\n\n## Troubleshooting\n\n**\"Mail.app access denied\" (-1743)**\nGrant automation permissions in System Settings > Privacy & Security > Automation.\n\n**Empty results**\nMake sure Mail.app is running and at least one account is connected.\n\n**Swift build fails during install**\nEnsure Xcode Command Line Tools are installed: `xcode-select --install`\n\n**Slow queries**\nReduce the `limit` parameter or specify a specific `account`/`mailbox` to narrow the search.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-5d848e12fea04855786466fb4eaa2b18"}