mcp-apple-mail 2.2.0__tar.gz

mcp_apple_mail-2.2.0/.claude-plugin/marketplace.json

@@ -0,0 +1,22 @@
+{
+  "name": "apple-mail-mcp",
+  "owner": {
+    "name": "Patrick Freyer",
+    "email": "freyer.patrick@bcg.com"
+  },
+  "metadata": {
+    "description": "Apple Mail MCP — natural language email management for Claude Code",
+    "version": "1.0.0"
+  },
+  "plugins": [
+    {
+      "name": "apple-mail",
+      "source": "./plugin",
+      "description": "Natural language interface for Apple Mail — search, compose, triage, organize, and analyze email with 24 MCP tools and an expert email management skill",
+      "version": "3.1.0",
+      "author": {
+        "name": "Patrick Freyer"
+      }
+    }
+  ]
+}

mcp_apple_mail-2.2.0/.gitignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual Environment
+venv/
+env/
+ENV/
+.venv
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+
+# MCP Development
+.mcp.json
+.claude/settings.local.json
+.claude/worktrees/
+docs/superpowers/plans/
+
+# Build artifacts
+apple-mail-mcpb/build/
+*.mcpb
+
+# Archive
+archive/
+
+# Logs
+*.log
+
+# Personal configuration examples (keep templates only)
+claude_desktop_config.json

mcp_apple_mail-2.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Patrick Freyer
+
+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.

mcp_apple_mail-2.2.0/PKG-INFO

@@ -0,0 +1,303 @@
+Metadata-Version: 2.4
+Name: mcp-apple-mail
+Version: 2.2.0
+Summary: MCP server giving AI assistants full access to Apple Mail - read, search, compose, organize & analyze emails
+Project-URL: Homepage, https://github.com/patrickfreyer/apple-mail-mcp
+Project-URL: Repository, https://github.com/patrickfreyer/apple-mail-mcp
+Project-URL: Issues, https://github.com/patrickfreyer/apple-mail-mcp/issues
+Project-URL: Changelog, https://github.com/patrickfreyer/apple-mail-mcp/blob/main/CHANGELOG.md
+Author: Patrick Freyer
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,apple-mail,applescript,automation,claude,email,macos,mcp,mcp-server
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Email
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=3.1.0
+Description-Content-Type: text/markdown
+
+# Apple Mail MCP Server
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI](https://img.shields.io/pypi/v/apple-mail-mcp)](https://pypi.org/project/apple-mail-mcp/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)
+[![GitHub stars](https://img.shields.io/github/stars/patrickfreyer/apple-mail-mcp?style=social)](https://github.com/patrickfreyer/apple-mail-mcp/stargazers)
+
+## Star History
+
+<a href="https://star-history.com/#patrickfreyer/apple-mail-mcp&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=patrickfreyer/apple-mail-mcp&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=patrickfreyer/apple-mail-mcp&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=patrickfreyer/apple-mail-mcp&type=Date" />
+ </picture>
+</a>
+
+An MCP server that gives AI assistants full access to Apple Mail -- read, search, compose, organize, and analyze emails via natural language. Built with [FastMCP](https://github.com/jlowin/fastmcp).
+
+## Quick Install
+
+**Prerequisites:** macOS with Apple Mail configured, Python 3.10+
+
+### Claude Code Plugin (Recommended)
+
+Two commands — gets you the MCP server, `/email-management` slash command, and the Email Management Expert skill:
+
+```bash
+claude plugin marketplace add patrickfreyer/apple-mail-mcp
+claude plugin install apple-mail@apple-mail-mcp
+```
+
+Then restart Claude Code.
+
+### Other Install Methods
+
+<details>
+<summary><strong>uvx (zero install, MCP server only)</strong></summary>
+
+```bash
+claude mcp add apple-mail -- uvx apple-mail-mcp
+```
+
+Or for Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "uvx",
+      "args": ["apple-mail-mcp"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>pip install (MCP server only)</strong></summary>
+
+```bash
+pip install apple-mail-mcp
+claude mcp add apple-mail -- apple-mail-mcp
+```
+
+</details>
+
+<details>
+<summary><strong>Claude Desktop MCPB</strong></summary>
+
+1. Download `apple-mail-mcp-v2.2.0.mcpb` from [Releases](https://github.com/patrickfreyer/apple-mail-mcp/releases)
+2. Open Claude Desktop → Settings → Developer → MCP Servers → Install from file
+3. Select the `.mcpb` file and grant Mail.app permissions
+
+</details>
+
+<details>
+<summary><strong>Manual setup</strong></summary>
+
+```bash
+git clone https://github.com/patrickfreyer/apple-mail-mcp.git
+cd apple-mail-mcp/plugin
+python3 -m venv venv
+venv/bin/pip install -r requirements.txt
+
+claude mcp add apple-mail -- /bin/bash $(pwd)/start_mcp.sh
+```
+
+</details>
+
+## Tools (22)
+
+### Reading & Search
+| Tool | Description |
+|------|-------------|
+| `get_inbox_overview` | Dashboard with unread counts, folders, and recent emails |
+| `list_inbox_emails` | List emails with account/read-status filtering and optional content preview |
+| `get_mailbox_unread_counts` | Unread counts per mailbox or per-account summary |
+| `list_accounts` | List all configured Mail accounts |
+| `search_emails` | Unified search — subject, sender, body text, dates, attachments, cross-account |
+| `get_email_thread` | Conversation thread view |
+
+### Organization
+| Tool | Description |
+|------|-------------|
+| `list_mailboxes` | Folder hierarchy with message counts |
+| `create_mailbox` | Create new mailboxes (supports nested paths) |
+| `move_email` | Move/archive emails with filters (subject, sender, date, read status, dry-run) |
+| `update_email_status` | Mark read/unread, flag/unflag — by filters or message IDs |
+| `manage_trash` | Soft delete, permanent delete, empty trash (with dry-run) |
+
+### Composition
+| Tool | Description |
+|------|-------------|
+| `compose_email` | Send new emails (plain text or HTML body) |
+| `reply_to_email` | Reply or reply-all with optional HTML body |
+| `forward_email` | Forward with optional message, CC/BCC |
+| `manage_drafts` | Create, list, send, and delete drafts |
+| `create_rich_email_draft` | Build a rich HTML `.eml` draft, open it in Mail, and optionally save it to Drafts |
+
+### Attachments
+| Tool | Description |
+|------|-------------|
+| `list_email_attachments` | List attachments with names and sizes |
+| `save_email_attachment` | Save attachments to disk |
+
+### Smart Inbox
+| Tool | Description |
+|------|-------------|
+| `get_awaiting_reply` | Find sent emails that haven't received a reply |
+| `get_needs_response` | Identify emails that likely need your response |
+| `get_top_senders` | Analyse most frequent senders by count or domain |
+
+### Analytics & Export
+| Tool | Description |
+|------|-------------|
+| `get_statistics` | Email analytics (volume, top senders, read ratios) |
+| `export_emails` | Export single emails or mailboxes to TXT/HTML |
+| `inbox_dashboard` | Interactive UI dashboard (requires mcp-ui-server) |
+
+## Configuration
+
+### Read-Only Mode
+
+Pass `--read-only` to disable tools that send email (`compose_email`, `reply_to_email`, `forward_email`). Draft management remains available (list, create, delete) but sending a draft via `manage_drafts` is blocked.
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "/path/to/venv/bin/python3",
+      "args": ["/path/to/apple_mail_mcp.py", "--read-only"]
+    }
+  }
+}
+```
+
+### User Preferences (Optional)
+
+Set the `USER_EMAIL_PREFERENCES` environment variable to give the assistant context about your workflow:
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "/path/to/venv/bin/python3",
+      "args": ["/path/to/apple_mail_mcp.py"],
+      "env": {
+        "USER_EMAIL_PREFERENCES": "Default to BCG account, show max 50 emails, prefer Archive and Projects folders"
+      }
+    }
+  }
+}
+```
+
+For `.mcpb` installs, configure this in Claude Desktop under **Developer > MCP Servers > Apple Mail MCP**.
+
+### Safety Limits
+
+Batch operations have conservative defaults to prevent accidental bulk actions:
+
+| Operation | Default Limit |
+|-----------|---------------|
+| `update_email_status` | 10 emails |
+| `manage_trash` | 5 emails |
+| `move_email` | 1 email |
+
+Override via function parameters when needed.
+
+## Usage Examples
+
+```
+Show me an overview of my inbox
+Search for emails about "project update" in my Gmail
+Reply to the email about "Domain name" with "Thanks for the update!"
+Move emails with "invoice" in the subject to my Archive folder
+Show me email statistics for the last 30 days
+Create a rich HTML draft for a weekly update and open it in Mail
+```
+
+### Rich HTML Drafts
+
+Use `create_rich_email_draft` when you need a visually formatted email, newsletter, or leadership update.
+
+- It generates an unsent `.eml` file with multipart plain-text + HTML bodies
+- It can open the draft directly in Mail for editing
+- It can optionally ask Mail to save the opened compose window into Drafts
+- It accepts partial details, so you can start with just an account and subject and fill in the rest later
+
+This is more reliable than injecting raw HTML into AppleScript `content`, which Mail often stores as literal markup.
+
+## Email Management Skill
+
+A companion [Claude Code Skill](plugin/skills/email-management/) is included that teaches Claude expert email workflows (Inbox Zero, daily triage, folder organization). When installed as a plugin, the skill is loaded automatically. For standalone MCP installs, copy it manually:
+
+```bash
+cp -r plugin/skills/email-management ~/.claude/skills/email-management
+```
+
+## Requirements
+
+- macOS with Apple Mail configured
+- Python 3.7+
+- `fastmcp` (+ optional `mcp-ui-server` for dashboard)
+- Claude Desktop or any MCP-compatible client
+- Mail.app permissions: Automation + Mail Data Access (grant in **System Settings > Privacy & Security > Automation**)
+
+## Troubleshooting
+
+| Issue | Fix |
+|-------|-----|
+| Mail.app not responding | Ensure Mail.app is running; check Automation permissions in System Settings |
+| Slow searches | Set `include_content: false` and lower `max_results` |
+| Mailbox not found | Use exact folder names; nested folders use `/` separator (e.g., `Projects/Alpha`) |
+| Permission errors | Grant access in **System Settings > Privacy & Security > Automation** |
+| Rich draft shows raw HTML | Use `create_rich_email_draft` instead of pasting HTML into `manage_drafts` or AppleScript `content` |
+
+## Project Structure
+
+```
+apple-mail-mcp/
+├── .claude-plugin/
+│   └── marketplace.json       # Marketplace manifest (for plugin distribution)
+├── plugin/                    # Claude Code plugin
+│   ├── .claude-plugin/
+│   │   └── plugin.json        # Plugin manifest
+│   ├── commands/              # /email-management slash command
+│   ├── skills/                # Email Management Expert skill
+│   ├── apple_mail_mcp/        # Python MCP server package (24 tools)
+│   ├── apple_mail_mcp.py      # Entry point
+│   ├── start_mcp.sh           # Startup wrapper (auto-creates venv)
+│   └── requirements.txt
+├── apple-mail-mcpb/           # MCPB build files (Claude Desktop)
+├── LICENSE
+└── README.md
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Commit and push
+4. Open a Pull Request
+
+## License
+
+MIT -- see [LICENSE](LICENSE).
+
+## Links
+
+- [Changelog](CHANGELOG.md)
+- [Issues](https://github.com/patrickfreyer/apple-mail-mcp/issues)
+- [Discussions](https://github.com/patrickfreyer/apple-mail-mcp/discussions)
+- [FastMCP](https://github.com/jlowin/fastmcp)
+- [Model Context Protocol](https://modelcontextprotocol.io)

mcp_apple_mail-2.2.0/README.md

@@ -0,0 +1,277 @@
+# Apple Mail MCP Server
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI](https://img.shields.io/pypi/v/apple-mail-mcp)](https://pypi.org/project/apple-mail-mcp/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)
+[![GitHub stars](https://img.shields.io/github/stars/patrickfreyer/apple-mail-mcp?style=social)](https://github.com/patrickfreyer/apple-mail-mcp/stargazers)
+
+## Star History
+
+<a href="https://star-history.com/#patrickfreyer/apple-mail-mcp&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=patrickfreyer/apple-mail-mcp&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=patrickfreyer/apple-mail-mcp&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=patrickfreyer/apple-mail-mcp&type=Date" />
+ </picture>
+</a>
+
+An MCP server that gives AI assistants full access to Apple Mail -- read, search, compose, organize, and analyze emails via natural language. Built with [FastMCP](https://github.com/jlowin/fastmcp).
+
+## Quick Install
+
+**Prerequisites:** macOS with Apple Mail configured, Python 3.10+
+
+### Claude Code Plugin (Recommended)
+
+Two commands — gets you the MCP server, `/email-management` slash command, and the Email Management Expert skill:
+
+```bash
+claude plugin marketplace add patrickfreyer/apple-mail-mcp
+claude plugin install apple-mail@apple-mail-mcp
+```
+
+Then restart Claude Code.
+
+### Other Install Methods
+
+<details>
+<summary><strong>uvx (zero install, MCP server only)</strong></summary>
+
+```bash
+claude mcp add apple-mail -- uvx apple-mail-mcp
+```
+
+Or for Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "uvx",
+      "args": ["apple-mail-mcp"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>pip install (MCP server only)</strong></summary>
+
+```bash
+pip install apple-mail-mcp
+claude mcp add apple-mail -- apple-mail-mcp
+```
+
+</details>
+
+<details>
+<summary><strong>Claude Desktop MCPB</strong></summary>
+
+1. Download `apple-mail-mcp-v2.2.0.mcpb` from [Releases](https://github.com/patrickfreyer/apple-mail-mcp/releases)
+2. Open Claude Desktop → Settings → Developer → MCP Servers → Install from file
+3. Select the `.mcpb` file and grant Mail.app permissions
+
+</details>
+
+<details>
+<summary><strong>Manual setup</strong></summary>
+
+```bash
+git clone https://github.com/patrickfreyer/apple-mail-mcp.git
+cd apple-mail-mcp/plugin
+python3 -m venv venv
+venv/bin/pip install -r requirements.txt
+
+claude mcp add apple-mail -- /bin/bash $(pwd)/start_mcp.sh
+```
+
+</details>
+
+## Tools (22)
+
+### Reading & Search
+| Tool | Description |
+|------|-------------|
+| `get_inbox_overview` | Dashboard with unread counts, folders, and recent emails |
+| `list_inbox_emails` | List emails with account/read-status filtering and optional content preview |
+| `get_mailbox_unread_counts` | Unread counts per mailbox or per-account summary |
+| `list_accounts` | List all configured Mail accounts |
+| `search_emails` | Unified search — subject, sender, body text, dates, attachments, cross-account |
+| `get_email_thread` | Conversation thread view |
+
+### Organization
+| Tool | Description |
+|------|-------------|
+| `list_mailboxes` | Folder hierarchy with message counts |
+| `create_mailbox` | Create new mailboxes (supports nested paths) |
+| `move_email` | Move/archive emails with filters (subject, sender, date, read status, dry-run) |
+| `update_email_status` | Mark read/unread, flag/unflag — by filters or message IDs |
+| `manage_trash` | Soft delete, permanent delete, empty trash (with dry-run) |
+
+### Composition
+| Tool | Description |
+|------|-------------|
+| `compose_email` | Send new emails (plain text or HTML body) |
+| `reply_to_email` | Reply or reply-all with optional HTML body |
+| `forward_email` | Forward with optional message, CC/BCC |
+| `manage_drafts` | Create, list, send, and delete drafts |
+| `create_rich_email_draft` | Build a rich HTML `.eml` draft, open it in Mail, and optionally save it to Drafts |
+
+### Attachments
+| Tool | Description |
+|------|-------------|
+| `list_email_attachments` | List attachments with names and sizes |
+| `save_email_attachment` | Save attachments to disk |
+
+### Smart Inbox
+| Tool | Description |
+|------|-------------|
+| `get_awaiting_reply` | Find sent emails that haven't received a reply |
+| `get_needs_response` | Identify emails that likely need your response |
+| `get_top_senders` | Analyse most frequent senders by count or domain |
+
+### Analytics & Export
+| Tool | Description |
+|------|-------------|
+| `get_statistics` | Email analytics (volume, top senders, read ratios) |
+| `export_emails` | Export single emails or mailboxes to TXT/HTML |
+| `inbox_dashboard` | Interactive UI dashboard (requires mcp-ui-server) |
+
+## Configuration
+
+### Read-Only Mode
+
+Pass `--read-only` to disable tools that send email (`compose_email`, `reply_to_email`, `forward_email`). Draft management remains available (list, create, delete) but sending a draft via `manage_drafts` is blocked.
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "/path/to/venv/bin/python3",
+      "args": ["/path/to/apple_mail_mcp.py", "--read-only"]
+    }
+  }
+}
+```
+
+### User Preferences (Optional)
+
+Set the `USER_EMAIL_PREFERENCES` environment variable to give the assistant context about your workflow:
+
+```json
+{
+  "mcpServers": {
+    "apple-mail": {
+      "command": "/path/to/venv/bin/python3",
+      "args": ["/path/to/apple_mail_mcp.py"],
+      "env": {
+        "USER_EMAIL_PREFERENCES": "Default to BCG account, show max 50 emails, prefer Archive and Projects folders"
+      }
+    }
+  }
+}
+```
+
+For `.mcpb` installs, configure this in Claude Desktop under **Developer > MCP Servers > Apple Mail MCP**.
+
+### Safety Limits
+
+Batch operations have conservative defaults to prevent accidental bulk actions:
+
+| Operation | Default Limit |
+|-----------|---------------|
+| `update_email_status` | 10 emails |
+| `manage_trash` | 5 emails |
+| `move_email` | 1 email |
+
+Override via function parameters when needed.
+
+## Usage Examples
+
+```
+Show me an overview of my inbox
+Search for emails about "project update" in my Gmail
+Reply to the email about "Domain name" with "Thanks for the update!"
+Move emails with "invoice" in the subject to my Archive folder
+Show me email statistics for the last 30 days
+Create a rich HTML draft for a weekly update and open it in Mail
+```
+
+### Rich HTML Drafts
+
+Use `create_rich_email_draft` when you need a visually formatted email, newsletter, or leadership update.
+
+- It generates an unsent `.eml` file with multipart plain-text + HTML bodies
+- It can open the draft directly in Mail for editing
+- It can optionally ask Mail to save the opened compose window into Drafts
+- It accepts partial details, so you can start with just an account and subject and fill in the rest later
+
+This is more reliable than injecting raw HTML into AppleScript `content`, which Mail often stores as literal markup.
+
+## Email Management Skill
+
+A companion [Claude Code Skill](plugin/skills/email-management/) is included that teaches Claude expert email workflows (Inbox Zero, daily triage, folder organization). When installed as a plugin, the skill is loaded automatically. For standalone MCP installs, copy it manually:
+
+```bash
+cp -r plugin/skills/email-management ~/.claude/skills/email-management
+```
+
+## Requirements
+
+- macOS with Apple Mail configured
+- Python 3.7+
+- `fastmcp` (+ optional `mcp-ui-server` for dashboard)
+- Claude Desktop or any MCP-compatible client
+- Mail.app permissions: Automation + Mail Data Access (grant in **System Settings > Privacy & Security > Automation**)
+
+## Troubleshooting
+
+| Issue | Fix |
+|-------|-----|
+| Mail.app not responding | Ensure Mail.app is running; check Automation permissions in System Settings |
+| Slow searches | Set `include_content: false` and lower `max_results` |
+| Mailbox not found | Use exact folder names; nested folders use `/` separator (e.g., `Projects/Alpha`) |
+| Permission errors | Grant access in **System Settings > Privacy & Security > Automation** |
+| Rich draft shows raw HTML | Use `create_rich_email_draft` instead of pasting HTML into `manage_drafts` or AppleScript `content` |
+
+## Project Structure
+
+```
+apple-mail-mcp/
+├── .claude-plugin/
+│   └── marketplace.json       # Marketplace manifest (for plugin distribution)
+├── plugin/                    # Claude Code plugin
+│   ├── .claude-plugin/
+│   │   └── plugin.json        # Plugin manifest
+│   ├── commands/              # /email-management slash command
+│   ├── skills/                # Email Management Expert skill
+│   ├── apple_mail_mcp/        # Python MCP server package (24 tools)
+│   ├── apple_mail_mcp.py      # Entry point
+│   ├── start_mcp.sh           # Startup wrapper (auto-creates venv)
+│   └── requirements.txt
+├── apple-mail-mcpb/           # MCPB build files (Claude Desktop)
+├── LICENSE
+└── README.md
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/my-feature`)
+3. Commit and push
+4. Open a Pull Request
+
+## License
+
+MIT -- see [LICENSE](LICENSE).
+
+## Links
+
+- [Changelog](CHANGELOG.md)
+- [Issues](https://github.com/patrickfreyer/apple-mail-mcp/issues)
+- [Discussions](https://github.com/patrickfreyer/apple-mail-mcp/discussions)
+- [FastMCP](https://github.com/jlowin/fastmcp)
+- [Model Context Protocol](https://modelcontextprotocol.io)