fix: remove Cmd+A before HTML paste to preserve attachments

README.md

@@ -7,7 +7,13 @@
 
 ## Star History
 
-[![Star History Chart](https://api.star-history.com/svg?repos=patrickfreyer/apple-mail-mcp&type=Date)](https://star-history.com/#patrickfreyer/apple-mail-mcp&Date)
+<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).
 
@@ -39,47 +45,49 @@ Restart Claude Desktop and grant Mail.app permissions when prompted.
 
 > **Tip:** An `.mcpb` bundle is also available on the [Releases](https://github.com/patrickfreyer/apple-mail-mcp/releases) page for one-click install in Claude Desktop.
 
-## Tools (26)
+## 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 |
-| `get_email_with_content` | Search emails with full content preview |
-| `get_unread_count` | Unread count per account |
+| `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 |
-| `get_recent_emails` | Recent emails from a specific account |
-| `get_recent_from_sender` | Recent emails from a sender with time-range filters |
-| `search_emails` | Advanced multi-criteria search (subject, sender, dates, attachments) |
-| `search_by_sender` | Find all emails from a specific sender |
-| `search_email_content` | Full-text search in email bodies |
-| `search_all_accounts` | Cross-account unified search |
-| `get_newsletters` | Detect newsletter and subscription emails |
+| `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 |
-| `move_email` | Move emails between folders (supports nested paths) |
-| `update_email_status` | Batch mark read/unread, flag/unflag |
-| `manage_trash` | Soft delete, permanent delete, empty trash |
+| `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 (TO, CC, BCC) |
-| `reply_to_email` | Reply or reply-all with optional CC/BCC |
+| `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 |
 |------|-------------|
@@ -89,6 +97,21 @@ Restart Claude Desktop and grant Mail.app permissions when prompted.
 
 ## 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:
@@ -129,8 +152,20 @@ 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](skill-email-management/) is included that teaches Claude expert email workflows (Inbox Zero, daily triage, folder organization). Install it alongside the MCP for intelligent, multi-step email management:
@@ -157,12 +192,13 @@ See [skill-email-management/README.md](skill-email-management/README.md) for det
 | 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/
-├── apple_mail_mcp.py          # Main MCP server (26 tools)
+├── apple_mail_mcp.py          # Main MCP server (27 tools)
 ├── requirements.txt           # Python dependencies
 ├── apple-mail-mcpb/           # MCP Bundle build files
 ├── skill-email-management/    # Email Management Expert Skill