@sempervirens-labs/apple-mail-mcp 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,13 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:github.com)",
+      "mcp__trigger__search_docs",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "WebFetch(domain:www.npmjs.com)",
+      "Bash(bun install)",
+      "Bash(osascript:*)",
+      "Bash(npm publish:*)"
+    ]
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,261 @@
+# Apple Mail MCP
+
+An MCP (Model Context Protocol) server for Apple Mail on macOS. Allows AI assistants like Claude to read, search, and send emails through Apple Mail.
+
+## Features
+
+- **List Accounts** - Get all configured email accounts
+- **List Mailboxes** - Get all mailboxes/folders for any account
+- **Get Emails** - Retrieve recent emails from any mailbox
+- **Search Emails** - Search by subject, sender, or content
+- **Unread Count** - Get unread email counts
+- **Send Email** - Compose and send emails with CC/BCC support
+
+## Requirements
+
+- macOS (uses AppleScript to communicate with Apple Mail)
+- [Bun](https://bun.sh/) runtime
+- Apple Mail app configured with at least one email account
+
+## Installation
+
+### From Source
+
+```bash
+git clone https://github.com/yourusername/apple-mail-mcp.git
+cd apple-mail-mcp
+bun install
+```
+
+### Using bunx (no installation required)
+
+```bash
+bunx @sempervirens-labs/apple-mail-mcp
+```
+
+## Configuration
+
+### Claude Code
+
+Add to your `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "bun",
+      "args": ["run", "/path/to/apple-mail-mcp/src/index.ts"]
+    }
+  }
+}
+```
+
+Or if published to npm:
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "bunx",
+      "args": ["apple-mail-mcp"]
+    }
+  }
+}
+```
+
+After adding the configuration, restart Claude Code for the changes to take effect.
+
+### Cursor
+
+Add to your Cursor MCP settings (Settings > MCP Servers):
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "bun",
+      "args": ["run", "/path/to/apple-mail-mcp/src/index.ts"]
+    }
+  }
+}
+```
+
+Or via Cursor's settings UI:
+1. Open Cursor Settings (`Cmd + ,`)
+2. Search for "MCP" or navigate to Extensions > MCP Servers
+3. Click "Add Server"
+4. Enter:
+   - **Name**: `apple-mail`
+   - **Command**: `bun`
+   - **Arguments**: `run`, `/path/to/apple-mail-mcp/src/index.ts`
+
+### Claude Desktop
+
+Add to your `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "bun",
+      "args": ["run", "/path/to/apple-mail-mcp/src/index.ts"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### `mail_list_accounts`
+
+List all email accounts configured in Apple Mail.
+
+```
+No parameters required
+```
+
+**Example response:**
+```json
+{
+  "accounts": ["personal@gmail.com", "iCloud", "work@company.com"]
+}
+```
+
+### `mail_list_mailboxes`
+
+List all mailboxes for a specific account or all accounts.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `account` | string | No | Account name to list mailboxes for |
+
+**Example response:**
+```json
+{
+  "mailboxes": [
+    {
+      "account": "iCloud",
+      "mailboxes": ["INBOX", "Drafts", "Sent Messages", "Archive", "Junk"]
+    }
+  ]
+}
+```
+
+### `mail_get_emails`
+
+Get recent emails from a mailbox.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `account` | string | No | - | Account name |
+| `mailbox` | string | No | "INBOX" | Mailbox name |
+| `limit` | number | No | 10 | Max emails to retrieve |
+| `includeContent` | boolean | No | false | Include email body |
+
+**Example response:**
+```json
+{
+  "emails": [
+    {
+      "id": 12345,
+      "subject": "Meeting tomorrow",
+      "sender": "John Doe <john@example.com>",
+      "dateSent": "Monday, 10. January 2025 at 09:30:00",
+      "isRead": false
+    }
+  ],
+  "count": 1
+}
+```
+
+### `mail_search`
+
+Search emails by subject, sender, or content.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `query` | string | **Yes** | - | Search query |
+| `account` | string | No | - | Limit search to account |
+| `mailbox` | string | No | - | Limit search to mailbox |
+| `limit` | number | No | 10 | Max results |
+
+### `mail_get_unread_count`
+
+Get the count of unread emails.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `account` | string | No | Account name |
+| `mailbox` | string | No | Mailbox name |
+
+**Example response:**
+```json
+{
+  "unreadCount": 42
+}
+```
+
+### `mail_send`
+
+Send an email using Apple Mail.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `to` | string or string[] | **Yes** | Recipient email(s) |
+| `subject` | string | **Yes** | Email subject |
+| `body` | string | **Yes** | Email body |
+| `cc` | string or string[] | No | CC recipient(s) |
+| `bcc` | string or string[] | No | BCC recipient(s) |
+| `from` | string | No | Sender (must be configured account) |
+
+**Example response:**
+```json
+{
+  "success": true,
+  "message": "Message sent successfully"
+}
+```
+
+## Permissions
+
+On first use, macOS will prompt you to grant permissions:
+1. **Automation** - Allow the terminal/app to control Apple Mail
+2. **Mail Access** - Allow access to your email data
+
+You can manage these in System Settings > Privacy & Security > Automation.
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run in development mode
+bun run dev
+
+# Run the server
+bun run start
+```
+
+## Troubleshooting
+
+### "No accounts found"
+- Ensure Apple Mail is running and has at least one account configured
+- Check that automation permissions are granted in System Settings
+
+### "Operation not permitted"
+- Grant automation permissions: System Settings > Privacy & Security > Automation
+- Ensure the terminal/app running the MCP server has permission to control Mail
+
+### Server not connecting
+- Restart your AI client (Claude Code, Cursor, etc.) after adding the MCP configuration
+- Verify the path to the server is correct in your configuration
+- Check that Bun is installed and accessible from your PATH
+
+## License
+
+MIT
+
+## Credits
+
+Built as an alternative to [apple-mcp](https://github.com/Dhravya/apple-mcp) with working mail operations using direct AppleScript execution.

package/bun.lock

@@ -0,0 +1,203 @@
+{
+  "lockfileVersion": 1,
+  "configVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "apple-mail-mcp",
+      "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.0.0",
+      },
+      "devDependencies": {
+        "@types/node": "^20.0.0",
+        "typescript": "^5.0.0",
+      },
+    },
+  },
+  "packages": {
+    "@hono/node-server": ["@hono/node-server@1.19.8", "", { "peerDependencies": { "hono": "^4" } }, "sha512-0/g2lIOPzX8f3vzW1ggQgvG5mjtFBDBHFAzI5SFAi2DzSqS9luJwqg9T6O/gKYLi+inS7eNxBeIFkkghIPvrMA=="],
+
+    "@modelcontextprotocol/sdk": ["@modelcontextprotocol/sdk@1.25.2", "", { "dependencies": { "@hono/node-server": "^1.19.7", "ajv": "^8.17.1", "ajv-formats": "^3.0.1", "content-type": "^1.0.5", "cors": "^2.8.5", "cross-spawn": "^7.0.5", "eventsource": "^3.0.2", "eventsource-parser": "^3.0.0", "express": "^5.0.1", "express-rate-limit": "^7.5.0", "jose": "^6.1.1", "json-schema-typed": "^8.0.2", "pkce-challenge": "^5.0.0", "raw-body": "^3.0.0", "zod": "^3.25 || ^4.0", "zod-to-json-schema": "^3.25.0" }, "peerDependencies": { "@cfworker/json-schema": "^4.1.1" }, "optionalPeers": ["@cfworker/json-schema"] }, "sha512-LZFeo4F9M5qOhC/Uc1aQSrBHxMrvxett+9KLHt7OhcExtoiRN9DKgbZffMP/nxjutWDQpfMDfP3nkHI4X9ijww=="],
+
+    "@types/node": ["@types/node@20.19.28", "", { "dependencies": { "undici-types": "~6.21.0" } }, "sha512-VyKBr25BuFDzBFCK5sUM6ZXiWfqgCTwTAOK8qzGV/m9FCirXYDlmczJ+d5dXBAQALGCdRRdbteKYfJ84NGEusw=="],
+
+    "accepts": ["accepts@2.0.0", "", { "dependencies": { "mime-types": "^3.0.0", "negotiator": "^1.0.0" } }, "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng=="],
+
+    "ajv": ["ajv@8.17.1", "", { "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", "require-from-string": "^2.0.2" } }, "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g=="],
+
+    "ajv-formats": ["ajv-formats@3.0.1", "", { "dependencies": { "ajv": "^8.0.0" } }, "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ=="],
+
+    "body-parser": ["body-parser@2.2.2", "", { "dependencies": { "bytes": "^3.1.2", "content-type": "^1.0.5", "debug": "^4.4.3", "http-errors": "^2.0.0", "iconv-lite": "^0.7.0", "on-finished": "^2.4.1", "qs": "^6.14.1", "raw-body": "^3.0.1", "type-is": "^2.0.1" } }, "sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA=="],
+
+    "bytes": ["bytes@3.1.2", "", {}, "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg=="],
+
+    "call-bind-apply-helpers": ["call-bind-apply-helpers@1.0.2", "", { "dependencies": { "es-errors": "^1.3.0", "function-bind": "^1.1.2" } }, "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ=="],
+
+    "call-bound": ["call-bound@1.0.4", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "get-intrinsic": "^1.3.0" } }, "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg=="],
+
+    "content-disposition": ["content-disposition@1.0.1", "", {}, "sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q=="],
+
+    "content-type": ["content-type@1.0.5", "", {}, "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA=="],
+
+    "cookie": ["cookie@0.7.2", "", {}, "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w=="],
+
+    "cookie-signature": ["cookie-signature@1.2.2", "", {}, "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg=="],
+
+    "cors": ["cors@2.8.5", "", { "dependencies": { "object-assign": "^4", "vary": "^1" } }, "sha512-KIHbLJqu73RGr/hnbrO9uBeixNGuvSQjul/jdFvS/KFSIH1hWVd1ng7zOHx+YrEfInLG7q4n6GHQ9cDtxv/P6g=="],
+
+    "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
+
+    "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
+
+    "depd": ["depd@2.0.0", "", {}, "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw=="],
+
+    "dunder-proto": ["dunder-proto@1.0.1", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.1", "es-errors": "^1.3.0", "gopd": "^1.2.0" } }, "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A=="],
+
+    "ee-first": ["ee-first@1.1.1", "", {}, "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow=="],
+
+    "encodeurl": ["encodeurl@2.0.0", "", {}, "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg=="],
+
+    "es-define-property": ["es-define-property@1.0.1", "", {}, "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g=="],
+
+    "es-errors": ["es-errors@1.3.0", "", {}, "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw=="],
+
+    "es-object-atoms": ["es-object-atoms@1.1.1", "", { "dependencies": { "es-errors": "^1.3.0" } }, "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA=="],
+
+    "escape-html": ["escape-html@1.0.3", "", {}, "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow=="],
+
+    "etag": ["etag@1.8.1", "", {}, "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg=="],
+
+    "eventsource": ["eventsource@3.0.7", "", { "dependencies": { "eventsource-parser": "^3.0.1" } }, "sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA=="],
+
+    "eventsource-parser": ["eventsource-parser@3.0.6", "", {}, "sha512-Vo1ab+QXPzZ4tCa8SwIHJFaSzy4R6SHf7BY79rFBDf0idraZWAkYrDjDj8uWaSm3S2TK+hJ7/t1CEmZ7jXw+pg=="],
+
+    "express": ["express@5.2.1", "", { "dependencies": { "accepts": "^2.0.0", "body-parser": "^2.2.1", "content-disposition": "^1.0.0", "content-type": "^1.0.5", "cookie": "^0.7.1", "cookie-signature": "^1.2.1", "debug": "^4.4.0", "depd": "^2.0.0", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "etag": "^1.8.1", "finalhandler": "^2.1.0", "fresh": "^2.0.0", "http-errors": "^2.0.0", "merge-descriptors": "^2.0.0", "mime-types": "^3.0.0", "on-finished": "^2.4.1", "once": "^1.4.0", "parseurl": "^1.3.3", "proxy-addr": "^2.0.7", "qs": "^6.14.0", "range-parser": "^1.2.1", "router": "^2.2.0", "send": "^1.1.0", "serve-static": "^2.2.0", "statuses": "^2.0.1", "type-is": "^2.0.1", "vary": "^1.1.2" } }, "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw=="],
+
+    "express-rate-limit": ["express-rate-limit@7.5.1", "", { "peerDependencies": { "express": ">= 4.11" } }, "sha512-7iN8iPMDzOMHPUYllBEsQdWVB6fPDMPqwjBaFrgr4Jgr/+okjvzAy+UHlYYL/Vs0OsOrMkwS6PJDkFlJwoxUnw=="],
+
+    "fast-deep-equal": ["fast-deep-equal@3.1.3", "", {}, "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q=="],
+
+    "fast-uri": ["fast-uri@3.1.0", "", {}, "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA=="],
+
+    "finalhandler": ["finalhandler@2.1.1", "", { "dependencies": { "debug": "^4.4.0", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "on-finished": "^2.4.1", "parseurl": "^1.3.3", "statuses": "^2.0.1" } }, "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA=="],
+
+    "forwarded": ["forwarded@0.2.0", "", {}, "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow=="],
+
+    "fresh": ["fresh@2.0.0", "", {}, "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A=="],
+
+    "function-bind": ["function-bind@1.1.2", "", {}, "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA=="],
+
+    "get-intrinsic": ["get-intrinsic@1.3.0", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.1.1", "function-bind": "^1.1.2", "get-proto": "^1.0.1", "gopd": "^1.2.0", "has-symbols": "^1.1.0", "hasown": "^2.0.2", "math-intrinsics": "^1.1.0" } }, "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ=="],
+
+    "get-proto": ["get-proto@1.0.1", "", { "dependencies": { "dunder-proto": "^1.0.1", "es-object-atoms": "^1.0.0" } }, "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g=="],
+
+    "gopd": ["gopd@1.2.0", "", {}, "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg=="],
+
+    "has-symbols": ["has-symbols@1.1.0", "", {}, "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ=="],
+
+    "hasown": ["hasown@2.0.2", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ=="],
+
+    "hono": ["hono@4.11.3", "", {}, "sha512-PmQi306+M/ct/m5s66Hrg+adPnkD5jiO6IjA7WhWw0gSBSo1EcRegwuI1deZ+wd5pzCGynCcn2DprnE4/yEV4w=="],
+
+    "http-errors": ["http-errors@2.0.1", "", { "dependencies": { "depd": "~2.0.0", "inherits": "~2.0.4", "setprototypeof": "~1.2.0", "statuses": "~2.0.2", "toidentifier": "~1.0.1" } }, "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ=="],
+
+    "iconv-lite": ["iconv-lite@0.7.2", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw=="],
+
+    "inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],
+
+    "ipaddr.js": ["ipaddr.js@1.9.1", "", {}, "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g=="],
+
+    "is-promise": ["is-promise@4.0.0", "", {}, "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ=="],
+
+    "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
+
+    "jose": ["jose@6.1.3", "", {}, "sha512-0TpaTfihd4QMNwrz/ob2Bp7X04yuxJkjRGi4aKmOqwhov54i6u79oCv7T+C7lo70MKH6BesI3vscD1yb/yzKXQ=="],
+
+    "json-schema-traverse": ["json-schema-traverse@1.0.0", "", {}, "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="],
+
+    "json-schema-typed": ["json-schema-typed@8.0.2", "", {}, "sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA=="],
+
+    "math-intrinsics": ["math-intrinsics@1.1.0", "", {}, "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="],
+
+    "media-typer": ["media-typer@1.1.0", "", {}, "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw=="],
+
+    "merge-descriptors": ["merge-descriptors@2.0.0", "", {}, "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g=="],
+
+    "mime-db": ["mime-db@1.54.0", "", {}, "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ=="],
+
+    "mime-types": ["mime-types@3.0.2", "", { "dependencies": { "mime-db": "^1.54.0" } }, "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A=="],
+
+    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
+
+    "negotiator": ["negotiator@1.0.0", "", {}, "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg=="],
+
+    "object-assign": ["object-assign@4.1.1", "", {}, "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg=="],
+
+    "object-inspect": ["object-inspect@1.13.4", "", {}, "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew=="],
+
+    "on-finished": ["on-finished@2.4.1", "", { "dependencies": { "ee-first": "1.1.1" } }, "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg=="],
+
+    "once": ["once@1.4.0", "", { "dependencies": { "wrappy": "1" } }, "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w=="],
+
+    "parseurl": ["parseurl@1.3.3", "", {}, "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ=="],
+
+    "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
+
+    "path-to-regexp": ["path-to-regexp@8.3.0", "", {}, "sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA=="],
+
+    "pkce-challenge": ["pkce-challenge@5.0.1", "", {}, "sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ=="],
+
+    "proxy-addr": ["proxy-addr@2.0.7", "", { "dependencies": { "forwarded": "0.2.0", "ipaddr.js": "1.9.1" } }, "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg=="],
+
+    "qs": ["qs@6.14.1", "", { "dependencies": { "side-channel": "^1.1.0" } }, "sha512-4EK3+xJl8Ts67nLYNwqw/dsFVnCf+qR7RgXSK9jEEm9unao3njwMDdmsdvoKBKHzxd7tCYz5e5M+SnMjdtXGQQ=="],
+
+    "range-parser": ["range-parser@1.2.1", "", {}, "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg=="],
+
+    "raw-body": ["raw-body@3.0.2", "", { "dependencies": { "bytes": "~3.1.2", "http-errors": "~2.0.1", "iconv-lite": "~0.7.0", "unpipe": "~1.0.0" } }, "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA=="],
+
+    "require-from-string": ["require-from-string@2.0.2", "", {}, "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="],
+
+    "router": ["router@2.2.0", "", { "dependencies": { "debug": "^4.4.0", "depd": "^2.0.0", "is-promise": "^4.0.0", "parseurl": "^1.3.3", "path-to-regexp": "^8.0.0" } }, "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ=="],
+
+    "safer-buffer": ["safer-buffer@2.1.2", "", {}, "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="],
+
+    "send": ["send@1.2.1", "", { "dependencies": { "debug": "^4.4.3", "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "etag": "^1.8.1", "fresh": "^2.0.0", "http-errors": "^2.0.1", "mime-types": "^3.0.2", "ms": "^2.1.3", "on-finished": "^2.4.1", "range-parser": "^1.2.1", "statuses": "^2.0.2" } }, "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ=="],
+
+    "serve-static": ["serve-static@2.2.1", "", { "dependencies": { "encodeurl": "^2.0.0", "escape-html": "^1.0.3", "parseurl": "^1.3.3", "send": "^1.2.0" } }, "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw=="],
+
+    "setprototypeof": ["setprototypeof@1.2.0", "", {}, "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw=="],
+
+    "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
+
+    "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
+
+    "side-channel": ["side-channel@1.1.0", "", { "dependencies": { "es-errors": "^1.3.0", "object-inspect": "^1.13.3", "side-channel-list": "^1.0.0", "side-channel-map": "^1.0.1", "side-channel-weakmap": "^1.0.2" } }, "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw=="],
+
+    "side-channel-list": ["side-channel-list@1.0.0", "", { "dependencies": { "es-errors": "^1.3.0", "object-inspect": "^1.13.3" } }, "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA=="],
+
+    "side-channel-map": ["side-channel-map@1.0.1", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "get-intrinsic": "^1.2.5", "object-inspect": "^1.13.3" } }, "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA=="],
+
+    "side-channel-weakmap": ["side-channel-weakmap@1.0.2", "", { "dependencies": { "call-bound": "^1.0.2", "es-errors": "^1.3.0", "get-intrinsic": "^1.2.5", "object-inspect": "^1.13.3", "side-channel-map": "^1.0.1" } }, "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A=="],
+
+    "statuses": ["statuses@2.0.2", "", {}, "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw=="],
+
+    "toidentifier": ["toidentifier@1.0.1", "", {}, "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA=="],
+
+    "type-is": ["type-is@2.0.1", "", { "dependencies": { "content-type": "^1.0.5", "media-typer": "^1.1.0", "mime-types": "^3.0.0" } }, "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@6.21.0", "", {}, "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="],
+
+    "unpipe": ["unpipe@1.0.0", "", {}, "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ=="],
+
+    "vary": ["vary@1.1.2", "", {}, "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg=="],
+
+    "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
+
+    "wrappy": ["wrappy@1.0.2", "", {}, "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ=="],
+
+    "zod": ["zod@4.3.5", "", {}, "sha512-k7Nwx6vuWx1IJ9Bjuf4Zt1PEllcwe7cls3VNzm4CQ1/hgtFUK2bRNG3rvnpPUhFjmqJKAKtjV576KnUkHocg/g=="],
+
+    "zod-to-json-schema": ["zod-to-json-schema@3.25.1", "", { "peerDependencies": { "zod": "^3.25 || ^4" } }, "sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA=="],
+  }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@sempervirens-labs/apple-mail-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Apple Mail - list accounts, mailboxes, search emails, and send messages",
+  "type": "module",
+  "main": "src/index.ts",
+  "bin": {
+    "apple-mail-mcp": "./src/index.ts"
+  },
+  "scripts": {
+    "start": "bun run src/index.ts",
+    "dev": "bun run --watch src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "apple",
+    "mail",
+    "email",
+    "macos",
+    "applescript",
+    "claude"
+  ],
+  "author": "Robert Bouschery",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rbouschery/apple-mail-mcp.git"
+  },
+  "homepage": "https://github.com/rbouschery/apple-mail-mcp#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/applescript/mail.ts

@@ -0,0 +1,356 @@
+import { execSync } from "child_process";
+
+/**
+ * Execute an AppleScript and return the result
+ */
+export function runAppleScript(script: string): string {
+  try {
+    // Use osascript with heredoc to handle complex scripts
+    const result = execSync(`osascript <<'APPLESCRIPT'
+${script}
+APPLESCRIPT`, {
+      encoding: "utf-8",
+      maxBuffer: 10 * 1024 * 1024, // 10MB buffer for large results
+    });
+    return result.trim();
+  } catch (error: any) {
+    throw new Error(`AppleScript error: ${error.message}`);
+  }
+}
+
+/**
+ * List all email accounts configured in Apple Mail
+ */
+export function listAccounts(): string[] {
+  const script = `
+tell application "Mail"
+    set accountList to {}
+    repeat with acc in accounts
+        set end of accountList to name of acc
+    end repeat
+    return accountList
+end tell
+`;
+  const result = runAppleScript(script);
+  if (!result) return [];
+
+  // AppleScript returns comma-separated list
+  return result.split(", ").map(s => s.trim()).filter(Boolean);
+}
+
+/**
+ * List mailboxes for a specific account or all accounts
+ */
+export function listMailboxes(accountName?: string): { account: string; mailboxes: string[] }[] {
+  const script = accountName
+    ? `
+tell application "Mail"
+    set results to {}
+    try
+        set acc to account "${accountName}"
+        set mailboxList to {}
+        repeat with mb in mailboxes of acc
+            set end of mailboxList to name of mb
+        end repeat
+        return mailboxList
+    on error
+        return {}
+    end try
+end tell
+`
+    : `
+tell application "Mail"
+    set results to ""
+    repeat with acc in accounts
+        set accName to name of acc
+        set mailboxList to {}
+        repeat with mb in mailboxes of acc
+            set end of mailboxList to name of mb
+        end repeat
+        set results to results & accName & ":" & (mailboxList as string) & "|||"
+    end repeat
+    return results
+end tell
+`;
+
+  const result = runAppleScript(script);
+
+  if (accountName) {
+    // Single account result
+    const mailboxes = result ? result.split(", ").map(s => s.trim()).filter(Boolean) : [];
+    return [{ account: accountName, mailboxes }];
+  }
+
+  // Multiple accounts result
+  const accountResults: { account: string; mailboxes: string[] }[] = [];
+  const parts = result.split("|||").filter(Boolean);
+
+  for (const part of parts) {
+    const [accName, ...mailboxParts] = part.split(":");
+    const mailboxes = mailboxParts.join(":").split(", ").map(s => s.trim()).filter(Boolean);
+    if (accName) {
+      accountResults.push({ account: accName.trim(), mailboxes });
+    }
+  }
+
+  return accountResults;
+}
+
+export interface Email {
+  id: number;
+  subject: string;
+  sender: string;
+  dateSent: string;
+  isRead: boolean;
+  content?: string;
+}
+
+/**
+ * Get emails from a mailbox
+ */
+export function getEmails(options: {
+  account?: string;
+  mailbox?: string;
+  limit?: number;
+  includeContent?: boolean;
+}): Email[] {
+  const { account, mailbox = "INBOX", limit = 10, includeContent = false } = options;
+
+  const contentPart = includeContent
+    ? `set msgContent to content of msg`
+    : `set msgContent to ""`;
+
+  const accountPart = account
+    ? `mailbox "${mailbox}" of account "${account}"`
+    : `mailbox "${mailbox}"`;
+
+  const script = `
+tell application "Mail"
+    set results to ""
+    try
+        set theMailbox to ${accountPart}
+        set msgList to messages of theMailbox
+        set msgCount to count of msgList
+        if msgCount > ${limit} then set msgCount to ${limit}
+
+        repeat with i from 1 to msgCount
+            set msg to item i of msgList
+            set msgId to id of msg
+            set msgSubject to subject of msg
+            set msgSender to sender of msg
+            set msgDate to date sent of msg
+            set msgRead to read status of msg
+            ${contentPart}
+
+            set results to results & msgId & "<<>>" & msgSubject & "<<>>" & msgSender & "<<>>" & (msgDate as string) & "<<>>" & msgRead & "<<>>" & msgContent & "|||"
+        end repeat
+    on error errMsg
+        return "ERROR:" & errMsg
+    end try
+    return results
+end tell
+`;
+
+  const result = runAppleScript(script);
+
+  if (result.startsWith("ERROR:")) {
+    throw new Error(result.substring(6));
+  }
+
+  const emails: Email[] = [];
+  const parts = result.split("|||").filter(Boolean);
+
+  for (const part of parts) {
+    const [id, subject, sender, dateSent, isRead, content] = part.split("<<>>");
+    emails.push({
+      id: parseInt(id) || 0,
+      subject: subject || "(No Subject)",
+      sender: sender || "(Unknown)",
+      dateSent: dateSent || "",
+      isRead: isRead === "true",
+      content: content || undefined,
+    });
+  }
+
+  return emails;
+}
+
+/**
+ * Search emails by query
+ */
+export function searchEmails(options: {
+  query: string;
+  account?: string;
+  mailbox?: string;
+  limit?: number;
+}): Email[] {
+  const { query, account, mailbox, limit = 10 } = options;
+
+  // Build the mailbox selection part
+  let mailboxPart: string;
+  if (account && mailbox) {
+    mailboxPart = `{mailbox "${mailbox}" of account "${account}"}`;
+  } else if (account) {
+    mailboxPart = `mailboxes of account "${account}"`;
+  } else if (mailbox) {
+    mailboxPart = `{mailbox "${mailbox}"}`;
+  } else {
+    mailboxPart = `inbox`;
+  }
+
+  const script = `
+tell application "Mail"
+    set results to ""
+    set foundCount to 0
+    set searchQuery to "${query.replace(/"/g, '\\"')}"
+
+    try
+        set searchMailboxes to ${mailboxPart}
+        repeat with mb in searchMailboxes
+            if foundCount >= ${limit} then exit repeat
+
+            set msgList to (messages of mb whose subject contains searchQuery or sender contains searchQuery or content contains searchQuery)
+            repeat with msg in msgList
+                if foundCount >= ${limit} then exit repeat
+
+                set msgId to id of msg
+                set msgSubject to subject of msg
+                set msgSender to sender of msg
+                set msgDate to date sent of msg
+                set msgRead to read status of msg
+
+                set results to results & msgId & "<<>>" & msgSubject & "<<>>" & msgSender & "<<>>" & (msgDate as string) & "<<>>" & msgRead & "|||"
+                set foundCount to foundCount + 1
+            end repeat
+        end repeat
+    on error errMsg
+        return "ERROR:" & errMsg
+    end try
+    return results
+end tell
+`;
+
+  const result = runAppleScript(script);
+
+  if (result.startsWith("ERROR:")) {
+    throw new Error(result.substring(6));
+  }
+
+  const emails: Email[] = [];
+  const parts = result.split("|||").filter(Boolean);
+
+  for (const part of parts) {
+    const [id, subject, sender, dateSent, isRead] = part.split("<<>>");
+    emails.push({
+      id: parseInt(id) || 0,
+      subject: subject || "(No Subject)",
+      sender: sender || "(Unknown)",
+      dateSent: dateSent || "",
+      isRead: isRead === "true",
+    });
+  }
+
+  return emails;
+}
+
+/**
+ * Get unread email count
+ */
+export function getUnreadCount(options: {
+  account?: string;
+  mailbox?: string;
+}): number {
+  const { account, mailbox } = options;
+
+  let script: string;
+
+  if (account && mailbox) {
+    script = `
+tell application "Mail"
+    return unread count of mailbox "${mailbox}" of account "${account}"
+end tell
+`;
+  } else if (account) {
+    script = `
+tell application "Mail"
+    set total to 0
+    repeat with mb in mailboxes of account "${account}"
+        set total to total + (unread count of mb)
+    end repeat
+    return total
+end tell
+`;
+  } else if (mailbox) {
+    script = `
+tell application "Mail"
+    set total to 0
+    repeat with acc in accounts
+        try
+            set total to total + (unread count of mailbox "${mailbox}" of acc)
+        end try
+    end repeat
+    return total
+end tell
+`;
+  } else {
+    script = `
+tell application "Mail"
+    set total to 0
+    repeat with acc in accounts
+        repeat with mb in mailboxes of acc
+            set total to total + (unread count of mb)
+        end repeat
+    end repeat
+    return total
+end tell
+`;
+  }
+
+  const result = runAppleScript(script);
+  return parseInt(result) || 0;
+}
+
+/**
+ * Send an email
+ */
+export function sendEmail(options: {
+  to: string | string[];
+  subject: string;
+  body: string;
+  cc?: string | string[];
+  bcc?: string | string[];
+  from?: string;
+}): { success: boolean; message: string } {
+  const { to, subject, body, cc, bcc, from } = options;
+
+  const toList = Array.isArray(to) ? to : [to];
+  const ccList = cc ? (Array.isArray(cc) ? cc : [cc]) : [];
+  const bccList = bcc ? (Array.isArray(bcc) ? bcc : [bcc]) : [];
+
+  // Build recipient parts
+  const toRecipients = toList.map(addr => `make new to recipient at end of to recipients with properties {address:"${addr}"}`).join("\n            ");
+  const ccRecipients = ccList.map(addr => `make new cc recipient at end of cc recipients with properties {address:"${addr}"}`).join("\n            ");
+  const bccRecipients = bccList.map(addr => `make new bcc recipient at end of bcc recipients with properties {address:"${addr}"}`).join("\n            ");
+
+  const fromPart = from ? `, sender:"${from}"` : "";
+
+  const script = `
+tell application "Mail"
+    set newMessage to make new outgoing message with properties {subject:"${subject.replace(/"/g, '\\"')}", content:"${body.replace(/"/g, '\\"').replace(/\n/g, "\\n")}"${fromPart}}
+    tell newMessage
+        ${toRecipients}
+        ${ccRecipients ? ccRecipients : ""}
+        ${bccRecipients ? bccRecipients : ""}
+    end tell
+    send newMessage
+    return "Message sent successfully"
+end tell
+`;
+
+  try {
+    const result = runAppleScript(script);
+    return { success: true, message: result || "Message sent successfully" };
+  } catch (error: any) {
+    return { success: false, message: error.message };
+  }
+}

package/src/index.ts

@@ -0,0 +1,176 @@
+#!/usr/bin/env bun
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+import { tools } from "./tools.js";
+import {
+  listAccounts,
+  listMailboxes,
+  getEmails,
+  searchEmails,
+  getUnreadCount,
+  sendEmail,
+} from "./applescript/mail.js";
+
+// Create MCP server
+const server = new Server(
+  {
+    name: "apple-mail-mcp",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// Handler for listing available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return { tools };
+});
+
+// Handler for tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case "mail_list_accounts": {
+        const accounts = listAccounts();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ accounts }, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "mail_list_mailboxes": {
+        const account = args?.account as string | undefined;
+        const result = listMailboxes(account);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ mailboxes: result }, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "mail_get_emails": {
+        const emails = getEmails({
+          account: args?.account as string | undefined,
+          mailbox: (args?.mailbox as string) || "INBOX",
+          limit: (args?.limit as number) || 10,
+          includeContent: (args?.includeContent as boolean) || false,
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ emails, count: emails.length }, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "mail_search": {
+        const query = args?.query as string;
+        if (!query) {
+          throw new Error("Search query is required");
+        }
+        const emails = searchEmails({
+          query,
+          account: args?.account as string | undefined,
+          mailbox: args?.mailbox as string | undefined,
+          limit: (args?.limit as number) || 10,
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ emails, count: emails.length, query }, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "mail_get_unread_count": {
+        const count = getUnreadCount({
+          account: args?.account as string | undefined,
+          mailbox: args?.mailbox as string | undefined,
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ unreadCount: count }, null, 2),
+            },
+          ],
+        };
+      }
+
+      case "mail_send": {
+        const to = args?.to as string | string[];
+        const subject = args?.subject as string;
+        const body = args?.body as string;
+
+        if (!to || !subject || !body) {
+          throw new Error("Required fields: to, subject, body");
+        }
+
+        const result = sendEmail({
+          to,
+          subject,
+          body,
+          cc: args?.cc as string | string[] | undefined,
+          bcc: args?.bcc as string | string[] | undefined,
+          from: args?.from as string | undefined,
+        });
+
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error: any) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify({ error: error.message }, null, 2),
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+// Start the server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Apple Mail MCP server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/src/tools.ts

@@ -0,0 +1,156 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+
+export const MAIL_LIST_ACCOUNTS: Tool = {
+  name: "mail_list_accounts",
+  description: "List all email accounts configured in Apple Mail",
+  inputSchema: {
+    type: "object",
+    properties: {},
+    required: [],
+  },
+};
+
+export const MAIL_LIST_MAILBOXES: Tool = {
+  name: "mail_list_mailboxes",
+  description: "List all mailboxes (folders) for a specific account or all accounts in Apple Mail",
+  inputSchema: {
+    type: "object",
+    properties: {
+      account: {
+        type: "string",
+        description: "The name of the email account to list mailboxes for. If not provided, lists mailboxes for all accounts.",
+      },
+    },
+    required: [],
+  },
+};
+
+export const MAIL_GET_EMAILS: Tool = {
+  name: "mail_get_emails",
+  description: "Get recent emails from a mailbox in Apple Mail",
+  inputSchema: {
+    type: "object",
+    properties: {
+      account: {
+        type: "string",
+        description: "The name of the email account",
+      },
+      mailbox: {
+        type: "string",
+        description: "The name of the mailbox/folder (default: INBOX)",
+        default: "INBOX",
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of emails to retrieve (default: 10)",
+        default: 10,
+      },
+      includeContent: {
+        type: "boolean",
+        description: "Whether to include the email body content (default: false)",
+        default: false,
+      },
+    },
+    required: [],
+  },
+};
+
+export const MAIL_SEARCH: Tool = {
+  name: "mail_search",
+  description: "Search emails in Apple Mail by subject, sender, or content",
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: {
+        type: "string",
+        description: "The search query to match against email subject, sender, or content",
+      },
+      account: {
+        type: "string",
+        description: "The name of the email account to search in",
+      },
+      mailbox: {
+        type: "string",
+        description: "The name of the mailbox/folder to search in",
+      },
+      limit: {
+        type: "number",
+        description: "Maximum number of emails to return (default: 10)",
+        default: 10,
+      },
+    },
+    required: ["query"],
+  },
+};
+
+export const MAIL_GET_UNREAD_COUNT: Tool = {
+  name: "mail_get_unread_count",
+  description: "Get the count of unread emails in Apple Mail",
+  inputSchema: {
+    type: "object",
+    properties: {
+      account: {
+        type: "string",
+        description: "The name of the email account",
+      },
+      mailbox: {
+        type: "string",
+        description: "The name of the mailbox/folder",
+      },
+    },
+    required: [],
+  },
+};
+
+export const MAIL_SEND: Tool = {
+  name: "mail_send",
+  description: "Send an email using Apple Mail",
+  inputSchema: {
+    type: "object",
+    properties: {
+      to: {
+        oneOf: [
+          { type: "string" },
+          { type: "array", items: { type: "string" } },
+        ],
+        description: "Email address(es) of the recipient(s)",
+      },
+      subject: {
+        type: "string",
+        description: "The email subject line",
+      },
+      body: {
+        type: "string",
+        description: "The email body content",
+      },
+      cc: {
+        oneOf: [
+          { type: "string" },
+          { type: "array", items: { type: "string" } },
+        ],
+        description: "Email address(es) for CC recipients",
+      },
+      bcc: {
+        oneOf: [
+          { type: "string" },
+          { type: "array", items: { type: "string" } },
+        ],
+        description: "Email address(es) for BCC recipients",
+      },
+      from: {
+        type: "string",
+        description: "The sender email address (must be a configured account)",
+      },
+    },
+    required: ["to", "subject", "body"],
+  },
+};
+
+export const tools: Tool[] = [
+  MAIL_LIST_ACCOUNTS,
+  MAIL_LIST_MAILBOXES,
+  MAIL_GET_EMAILS,
+  MAIL_SEARCH,
+  MAIL_GET_UNREAD_COUNT,
+  MAIL_SEND,
+];

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "outDir": "dist",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}