@redpop/apple-mail-mcp 0.1.0 → 0.1.1

package/README.md

@@ -24,8 +24,8 @@ The main use is "find the mail about X":
 
 Four tools: `list_mailboxes`, `search_messages`, `get_message`, `get_thread`. Search covers
 sender, recipient, subject, free text, mailbox, date range, unread, flagged and attachments,
-and can also look inside message bodies. Every result carries a `message://` link that opens
-the mail in Mail.app. Details: [`docs/tools.md`](./docs/tools.md).
+and can also look inside message bodies. Results carry a `message://` link that opens the
+mail in Mail.app, where Mail stores the Message-ID (not on macOS 15). Details: [`docs/tools.md`](./docs/tools.md).
 
 ## Why this one
 
@@ -42,8 +42,8 @@ the mail in Mail.app. Details: [`docs/tools.md`](./docs/tools.md).
 - **Mail.app does not have to be running** and no Automation prompt appears. Your data is
   only as fresh as Mail's last sync, though, and a message that Mail never downloaded has no
   body.
-- **Threads and deep links.** `get_thread` returns a conversation; every message has a
-  `message://` link.
+- **Threads and deep links.** `get_thread` returns a conversation; messages carry a
+  `message://` link (not on macOS 15).
 - **Security mails are withheld by default.** Messages that look like verification codes,
   password resets or sign-in links are shown without their body, with digits in the subject
   masked, and cannot be found by body search. Detection is best effort, not a guarantee.
@@ -55,13 +55,17 @@ the mail in Mail.app. Details: [`docs/tools.md`](./docs/tools.md).
 
 ## Requirements
 
-- macOS. Tested on macOS 27; expected to work on macOS 14 and later. Support depends on the
-  layout of Mail's database, not on the version number: `doctor` checks it. Reports from other
-  versions are welcome, see [Reporting problems](#reporting-problems).
+- macOS 15 or later. Verified with a real mailbox only on macOS 27.0.1 with Mail 16.0. The
+  database layout of macOS 15.8 and 26.6 passes the helper's column check, taken from runners
+  without a mail account. On macOS 15 Mail stores no Message-ID header, so results there carry
+  no `message://` link. Support depends on the layout of Mail's database, not on the version
+  number: `doctor` checks it.
+  Reports from other versions are welcome, see [Reporting problems](#reporting-problems).
 - Node.js 22 or newer.
 - Mail set up with at least one account.
-- Exchange accounts are untested. Message metadata should work; bodies of Exchange mail are
-  unverified.
+- Exchange accounts are untested. Mailboxes and message metadata are listed, but bodies of
+  Exchange mail are not read yet: `get_message` reports `file_not_found`. See
+  [`docs/exchange.md`](./docs/exchange.md).
 
 ## Security model in short
 
@@ -220,15 +224,17 @@ least one check failed.
 ## Reporting problems
 
 Open an issue at <https://github.com/redpop/apple-mail-mcp/issues> and attach the output of
-`doctor`. If you run it on a macOS version other than 27, say so: that is the most useful
-report we can get. Security problems go through GitHub Security Advisories, see
-[`SECURITY.md`](./SECURITY.md).
+`doctor`. If you run it on a macOS version other than 27, open a
+[Schema report](https://github.com/redpop/apple-mail-mcp/issues/new?template=schema-report.yml)
+with the output of `doctor --schema` instead: that is the most useful report we can get.
+Security problems go through GitHub Security Advisories, see [`SECURITY.md`](./SECURITY.md).
 
 ## More documentation
 
 - [`docs/tools.md`](./docs/tools.md): every tool, its parameters, results and errors
 - [`docs/architecture.md`](./docs/architecture.md): how it works and what was measured
 - [`docs/troubleshooting.md`](./docs/troubleshooting.md): permission and database problems
+- [`docs/exchange.md`](./docs/exchange.md): what is known about Exchange accounts
 - [`SECURITY.md`](./SECURITY.md): threat model and residual risks
 - [`docs/releasing.md`](./docs/releasing.md): how releases are built, signed and published (maintainers)
 

package/bin/Mail MCP Helper.app/Contents/Info.plist

@@ -15,11 +15,11 @@
   <key>CFBundlePackageType</key>
   <string>APPL</string>
   <key>CFBundleShortVersionString</key>
-  <string>0.1.0</string>
+  <string>0.1.1</string>
   <key>CFBundleVersion</key>
-  <string>0.1.0</string>
+  <string>0.1.1</string>
   <key>LSMinimumSystemVersion</key>
-  <string>14.0</string>
+  <string>15.0</string>
   <key>LSUIElement</key>
   <true/>
 </dict>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redpop/apple-mail-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "mcpName": "io.github.redpop/apple-mail-mcp",
   "description": "Read-only MCP server for Apple Mail on macOS: search and read mail, mailboxes and threads, with a Full Disk Access grant that only a signed helper holds",
   "license": "MIT",