@mgcrea/mcp-apple-mail 1.36.1 → 1.37.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/dist/cli.js +1 -1
- package/dist/index.d.ts +10 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/{server-BcVfuC1E.js → server-D5S4dzq6.js} +286 -72
- package/dist/server-D5S4dzq6.js.map +1 -0
- package/package.json +2 -2
- package/dist/server-BcVfuC1E.js.map +0 -1
package/README.md
CHANGED
|
@@ -165,7 +165,15 @@ wrong:
|
|
|
165
165
|
164,156-byte PDF advertises 224,634.
|
|
166
166
|
|
|
167
167
|
`list_attachments` therefore reports `sizeBytes` from the file on disk and a `retrievable` flag
|
|
168
|
-
saying whether
|
|
168
|
+
saying whether the bytes are on disk, rather than guessing from the message.
|
|
169
|
+
|
|
170
|
+
An attachment with `retrievable: false` has not been downloaded by Mail, which on a Gmail account
|
|
171
|
+
caching messages without their attachments is most older mail. `save_attachment` then asks Mail to
|
|
172
|
+
save it, and Mail's `save` fetches it from the server first; the result says `from: "mail"`. Mail
|
|
173
|
+
also keeps what it fetched, so the attachment reads `retrievable: true` afterwards. Mail has to be
|
|
174
|
+
running and online, a large file can take a while (Mail allows itself two minutes), and Mail writes into a
|
|
175
|
+
staging folder inside `APPLE_MAIL_ATTACHMENT_DIR` that is removed after the copy, never into the
|
|
176
|
+
destination itself.
|
|
169
177
|
|
|
170
178
|
## Security
|
|
171
179
|
|
|
@@ -182,8 +190,10 @@ Once implemented, sending will default to leaving a **draft** open for review; a
|
|
|
182
190
|
requires both `ALLOW_WRITES` and an explicit `confirm: true`.
|
|
183
191
|
|
|
184
192
|
**No secrets.** The server holds no credential of any kind — its access is the macOS permission you
|
|
185
|
-
granted the host app. There is nothing here to leak, and nothing is sent anywhere:
|
|
186
|
-
|
|
193
|
+
granted the host app. There is nothing here to leak, and nothing is sent anywhere: the server makes
|
|
194
|
+
no network calls at all. What reaches a network is Mail itself, doing what it was asked: sending,
|
|
195
|
+
checking for new mail, and also `save_attachment` asking it to download an attachment from your own
|
|
196
|
+
mail server.
|
|
187
197
|
|
|
188
198
|
**Attachments.** `save_attachment` can only write inside `APPLE_MAIL_ATTACHMENT_DIR`, and the
|
|
189
199
|
filename is reduced to its basename first — a sender who names their attachment
|
package/dist/cli.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import { a as loadConfig, b as MAIL_SURFACE, j as BUILD_INFO, r as createServer } from "./server-
|
|
2
|
+
import { a as loadConfig, b as MAIL_SURFACE, j as BUILD_INFO, r as createServer } from "./server-D5S4dzq6.js";
|
|
3
3
|
import { runStdioServer } from "@mgcrea/mcp-apple-core";
|
|
4
4
|
//#region src/cli.ts
|
|
5
5
|
const LOG_PREFIX = "apple-mail-mcp";
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { AppBusyError as MailBusyError, AppNotRunningError as MailNotRunningError, AppleAutomationError, AppleAutomationError as AppleMailError, ArrivalRow, ArrivalSource, BuildInfo, Era, FileIdentity, IndexUnavailableError, InterferenceWatch, JxaEnvelope, ListenLedger, Logger, OsascriptRunner, OsascriptTimeoutError, PlatformError, PreconditionError, ProtocolError, SchemaDriftError, TccDeniedError, Watch, WatchRegistry, WritesDisabledError, assertStaticScript, createOsascriptRunner, inspectFile, mapOsaError, normalizeFilter, withBusyRetry } from "@mgcrea/mcp-apple-core";
|
|
1
|
+
import { AppBusyError as MailBusyError, AppNotRunningError as MailNotRunningError, AppleAutomationError, AppleAutomationError as AppleMailError, ArrivalRow, ArrivalSource, BuildInfo, Era, FileIdentity, IndexUnavailableError, InterferenceWatch, JxaEnvelope, ListenLedger, Logger, OsascriptRunner, OsascriptTimeoutError, PlatformError, PreconditionError, PreconditionError as PreconditionError$1, ProtocolError, SchemaDriftError, TccDeniedError, Watch, WatchRegistry, WritesDisabledError, assertStaticScript, createOsascriptRunner, inspectFile, mapOsaError, normalizeFilter, withBusyRetry } from "@mgcrea/mcp-apple-core";
|
|
2
2
|
import { z } from "zod";
|
|
3
3
|
import { McpServer } from "@modelcontextprotocol/server";
|
|
4
4
|
import { DatabaseSync } from "node:sqlite";
|
|
@@ -395,7 +395,10 @@ type ParsedMessage = {
|
|
|
395
395
|
headers: Record<string, string | null>;
|
|
396
396
|
body: string;
|
|
397
397
|
bodyFrom: "text/plain" | "text/html" | "none";
|
|
398
|
-
/**
|
|
398
|
+
/**
|
|
399
|
+
* `retrievable` says whether the bytes are on disk. When they are not,
|
|
400
|
+
* save_attachment has Mail download them, which needs Mail running and online.
|
|
401
|
+
*/
|
|
399
402
|
attachments: (Attachment & {
|
|
400
403
|
retrievable: boolean;
|
|
401
404
|
})[];
|
|
@@ -1009,13 +1012,17 @@ declare class AppleMailClient {
|
|
|
1009
1012
|
* The destination is resolved and then checked to be inside
|
|
1010
1013
|
* `APPLE_MAIL_ATTACHMENT_DIR`, so a filename of `../../.ssh/authorized_keys`
|
|
1011
1014
|
* lands nowhere. Existing files are never overwritten.
|
|
1015
|
+
*
|
|
1016
|
+
* When the bytes are not on disk, which on a Gmail account caching messages
|
|
1017
|
+
* without their attachments is most older mail, Mail is asked to download
|
|
1018
|
+
* the attachment (see `#fetchFromMail`).
|
|
1012
1019
|
*/
|
|
1013
1020
|
saveAttachment(ref: string, filename: string, opts?: {
|
|
1014
1021
|
overwrite?: boolean;
|
|
1015
1022
|
}): Promise<{
|
|
1016
1023
|
path: string;
|
|
1017
1024
|
bytes: number;
|
|
1018
|
-
from: "inline" | "sidecar";
|
|
1025
|
+
from: "inline" | "sidecar" | "mail";
|
|
1019
1026
|
}>;
|
|
1020
1027
|
/** Set flags across refs, one Apple Event per distinct mailbox. */
|
|
1021
1028
|
setFlags(refs: string[], flags: {
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/build-info.ts","../src/client/errors.ts","../src/client/locate.ts","../src/config.ts","../src/client/ax.ts","../src/client/mime.ts","../src/client/emlx.ts","../src/client/schema.ts","../src/client/envelope.ts","../src/client/mailbox-map.ts","../src/client/mail.ts","../src/client/ref.ts","../src/client/watch.ts","../src/tools/watch.ts","../src/server.ts","../src/tools/index.ts"],"mappings":";;;;;cAkBa,YAAY;;;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/build-info.ts","../src/client/errors.ts","../src/client/locate.ts","../src/config.ts","../src/client/ax.ts","../src/client/mime.ts","../src/client/emlx.ts","../src/client/schema.ts","../src/client/envelope.ts","../src/client/mailbox-map.ts","../src/client/mail.ts","../src/client/ref.ts","../src/client/watch.ts","../src/tools/watch.ts","../src/server.ts","../src/tools/index.ts"],"mappings":";;;;;cAkBa,YAAY;;;;cCeZ,6BAA6B;WACtB;EAElB,YAAY;;;;;;;;;;;;;;;;;;;;KCbF;;EAEV;;EAEA;EACA;;EAEA;EACA;EACA;EACA;EACA;;EAEA;EACA;EACA;;KAKU;;EAEV;;EAEA;;EAEA;;EAEA;;cAiBW,sBAAmB,OAAU,kBAAqB;;;;;;;;;;;;;;;cC3CzD,cAAY,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFP,EAAA,KAAA;KAEC,SAAS,EAAE,aAAa;;;;;cAMvB,aAAU,MAAS,OAAO,eAA2B;;;KCxCtD;EAAgB;EAAgB;EAAc;;;KAG9C;;;;;;;;;EASV;;;;;;;;;;;EAWA;;EAEA;;;;;;;;EAQA;;EAEA;;EAEA;;EAEA;EACA;EACA;;EAEA;;EAEA;EACA;;;;;;EAMA;;EAEA;;EAEA;;;;;;EAMA;;EAEA;;KAGU;EACV;EACA;;;;;;;EAOA;EACA;EACA;IAAU;IAAc;;EACxB;EACA;EACA;;KAGU;EACV;;EAEA;EACA;;KAiBU;EACV;EACA;;cAGW;;UAUJ;;SAOA,KACL,MAAK,OAAO,YACZ,OAAM,oBACL;EAKH;;EAKA,SAAS;;;;;;;EAcH,UAAU,sBAAsB,QAAQ;;;;;;;;;;;;EAmBxC,aAAa,MAAM,mBAAmB,QAAQ;;;;;;;;EA0C9C,WAAW;;;;;;;;;;;;;;;;;;EAqBX,SAAS,QAAQ;;;;;;;;;;;;;;;SA2BhB,aAAa;;kBAUJ;;;;;;;;;;;;;;;;;EAkBV,aAAa,iBAAiB,oBAAoB,QAAQ;;EA4B1D,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDZ,OACJ,kBACA,KAAK,aACL,cAAc,mBACb;;;;;;;;;;;;;EAiCG,aAAa,iBAAiB,oBAAoB;;;;KChd9C;EACV;EACA;EACA;;;;;;;;;EASA;;EAEA;;;;;;;;;;;;;;;;;;;;;KCGU;EACV,SAAS;EACT;EACA;;;;;EAKA,cAAc;IAAe;;EAC7B;EACA;EACA;EACA;;;;KC9BU;EACV;EACA,QAAQ;EACR;IACE;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;;EAGF;EACA;EACA;;;;KChBU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;;;cAUW;KAED,qBAAqB;KAErB;;EAEV;;EAEA;EACA;EACA;EACA;EACA;;KAGU;EACV,QAAQ;;EAER;;EAEA;;;KAIU;EACV;;EAEA;EACA;;EAEA;;EAEA;EACA;EACA;EACA;EACA;;KAOU;EACV,IAAI;;EAEJ;EACA,MAAM;;cA+BK;;WAEF,MAAM;WACN;EAET,YAAY,QAAQ;EAMpB;;EASA;IAAe;IAAe;IAAa;IAAsB;;EA2IjE,OAAO,SAAS,gBAAgB;;;;;;;;;;EA0FhC,QAAQ,SAAS,KAAK,0BAA0B,OAAO,aAAa;;;;;;;;EAsDpE,MAAM,SAAS,KAAK;IAAoC;IAAe;;;;;;;;;;;;;;;;;;;;;EA+BvE,YACE;IAAU;IAAa;QACtB;IAAc;IAAe;;;;;;;;;EAsChC,QAAQ,gBAAgB;;EA6BxB,OAAO,wBAAwB,gBAAgB;;EAmC/C;;;;;;;;;;;;EAkBA,cAAc,eAAe,gBAAgB;;EAoC7C,WAAW;;;;;;;;;;;EAcX,sBAAsB;IAAmB;IAAe;;;EAgBxD,eAAe;;;;;;;;;;;;;KCzoBL;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV,QAAQ;;EAER;EACA;EACA;;cAGW;;EAUX,YAAY,MAAM;;;;;;;EAqBZ,SAAS,kBAAgB,QAAQ;;;;;;EA8BjC,eAAe,iBAAiB,QAAQ;;;;;;EAwB9C,mBAAmB,SAAS,aAAa;;;;;;EAwBnC,gBAAgB,cAAc;IAAU,SAAS;IAAa;;;;;;;EASpE,kBACE,mBAAmB,eACnB;IACG,SAAS;IAAa;;EAc3B;;;;KCnDU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;;;;;;;;;;;KAYU;EAEN;EACA;EACA;EACA;;EAEA;EACA;EACA;;EAEA;EAAsB;EAAoB;;KA6BpC;EACV,QAAQ;EACR,SAAS;EACT,YAAY;;;;;;;;;EASZ,KAAK;;cA0BM;;WACF,QAAQ;WACR,QAAQ;WACR,WAAW;EAkBpB,YAAY,MAAM;;MAuBd;EAIJ,SAAS,kBAAgB,QAAQ;;;;;;EAS3B,OAAO,kBAAgB,QAAQ;;;;;;;;;;;;;EA+B/B,kBAAkB;IACtB;IACA;;;;;;;;;IASA;IACA;;;;;;;;;;;;EAwBI,mBAAmB;IAAU;IAAa;;EAM1C,SAAS,QAAQ;;;;;;;;;;;EA4CjB,cAAc;IAAQ;IAAyB;MAAwB;IAEzE;IACA;IACA;IACA;IACA;IACA;;;;;;;EAyFE,aACJ,SAAS,aACT,iBACA,gBACC;IACC;IAAiB;IAAe,UAAU;;IACtC;;IACA;IAAuB;;;;;;;EAuBzB,cACJ,SAAS,aACT,kBACC;IACG;IAAiB;IAAe;MAAU;;IAAiB;;IAE3D;IACA;IACA;MAAU;MAA4B;;IACtC;IACA;;EAmBA,aAAa,SAAS,aAAa,kBAAe;IAIrC;IACJ;IACF;IACC;;;;;;;EAUR,WACJ,SAAS,aACT,iBACA,gBACC;IAAU;IAAiB;IAAe,UAAU;;;EAcjD,YACJ;IAAO;IAAqB;KAC5B,eACA;IAAQ;IAAuB;IAAsB;MACpD,QAAQ;;;;;;EAwBL,SAAS,QAAQ;MAwBnB;;EAKE,mBAAmB;;;;;;;;EAanB,iBAAiB,QACrB;IAAc;IAAqB;IAAiB;;;;;;;;EAuBhD,iBAAiB,kBAAkB;;;;;;;;;EA8DnC,cACJ,MAAM,KAAK;IACT;IACA;KAEF,OAAO,aACN,SACE;IACC;IACA;IACA;;EAoCA,eACJ,MAAM,KAAK;IACT;IACA;;IAEA;MAED;IACD,UAAU;IACV;IACA;IACA;IACA;IACA,WAAW;;EA4GP,SAAS,aAAa,gBAAgB,QAAQ;;;;;;;;;EAkD9C,eACJ,aACA;IAAQ;MACP;IACD,SAAS;IACT,QAAQ;IACR;;IAEA;;;;;;;;;EAiCI,gBACJ,aACA;IAAQ;MACP;IAAU,QAAQ;IAAe;;IAAqB;IAAc;;EAmBjE,iBACJ,aACA;IAAQ;IAAgB;MACvB;IACD;IACA;IACA;IACA;IACA;;;;;;;;;;;;;;;EA2HI,oBAAoB;IAEtB;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;;;;;;;;;;;;EAkIE,eACJ,aACA,kBACA;IAAQ;MACP;IAAU;IAAc;IAAe;;;EAqLpC,SACJ,gBACA;IAAS;IAAgB;IAAmB;IAAoB;MAC/D;IAAU;IAAiB;IAAgB;;EA6BxC,aACJ,gBACA;IAAQ;IAA4B;MACnC;IAAU;IAAe;IAAgB;IAAqB;;EAqD3D,eAAe,iBAAiB;IACpC;IACA;IACA;IACA;;;;;;;;;;;;;;EAuCI,cACJ,cACA,mBACC;IACD;IACA;IACA;IACA;IACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqEI,YACJ;IAAU;IAA0B;KACpC;IACE;IACA;MAAU;MAAc;;IACxB;IACA;MAED,QAAQ;;;;;;;;;;;;EA+RL,eACJ;IAAQ;MACP,QAAQ;EA2FL,gBAAgB,mBAAmB;EAKnC,YAAY;IAChB;IACA;IACA;IACA;IACA;IACA;IACA;IACA;MACE;EA0CE,eACJ,aACA;IACE;IACA;IACA;IACA;IACA;IACA;MAED;;;;;;;;;;;;;;;;;;;;;cC9kEQ;KAED;EACV;EACA;EACA;;cAKW,YAAS,KAAS;cAGlB,YAAS,gBAAkB;;cA2B3B,qBAAkB,MAAU,iBAAe,YAAY;;;;;;;;;;;;;;KCzCxD,cAAc;;EAExB;EACA;EACA;EACA;EACA;EACA;;;;KC+GU;EACV,QAAQ;EACR,QAAQ,KAAK;EACb,SAAS;;EAET,uBAAuB;EACvB;;;;;;;EAOA;;cAGW;;;WA2CF,QAAQ,cAAc;EAO/B,YAAY,MAAM;;MAWd;;EAKJ,KAAK,UAAU,cAAc;;;;;;;;;;;;;;;;;EAyB7B,UAAU;;;;;;;;;;;EA+LJ,UAAU,mBAAmB;;;;;;EAwBnC,WAAW,mBAAmB;;;;;;EAiB9B,eAAY;IAA6B;;;EAgBzC;EAQA,OAAO;;EAKP,YAAY;;;;;;;;EAWN,oBAAoB,qBAAqB,oBAAoB;;;;;;EAgC7D,kBAAkB,sBAAsB;;EAcxC,IACJ,QAAQ,kBAAkB,kBAC1B,kCACC;IAAU,OAAO;IAAO;;;;;cChiBhB;cACA;KAED;EACV,QAAQ;EACR,SAAS;;EAET,YAAY;;EAEZ,MAAM;;EAEN,UAAU;;EAEV,sBAAsB;;KAGZ;EACV,QAAQ;EACR,QAAQ;;EAER,UAAU;;EAEV,SAAS;;;;;;;cAQE,eAAY,MAAU,wBAAsB;;;KCvC7C;;;;;EAKV;;;;;EAKA,UAAU;;;;;;;;;;;;;cAcC,gBAAa,QAChB,WAAS,QACT,iBAAe,KAClB"}
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { A as WritesDisabledError, C as MessageNotFoundError, D as ProtocolError, E as PreconditionError, O as SchemaDriftError, S as MailNotRunningError, T as PlatformError, _ as locateEnvelopeIndex, a as loadConfig, c as decodeRef, d as assertStaticScript, f as createOsascriptRunner, g as inspectFile, h as MailboxMap, i as registerTools, j as BUILD_INFO, k as TccDeniedError, l as encodeRef, m as withBusyRetry, n as SERVER_VERSION, o as AppleMailClient, p as mapOsaError, r as createServer, s as REF_VERSION, t as SERVER_NAME, u as groupRefsByMailbox, v as AppleMailError, w as OsascriptTimeoutError, x as MailBusyError, y as IndexUnavailableError } from "./server-
|
|
1
|
+
import { A as WritesDisabledError, C as MessageNotFoundError, D as ProtocolError, E as PreconditionError, O as SchemaDriftError, S as MailNotRunningError, T as PlatformError, _ as locateEnvelopeIndex, a as loadConfig, c as decodeRef, d as assertStaticScript, f as createOsascriptRunner, g as inspectFile, h as MailboxMap, i as registerTools, j as BUILD_INFO, k as TccDeniedError, l as encodeRef, m as withBusyRetry, n as SERVER_VERSION, o as AppleMailClient, p as mapOsaError, r as createServer, s as REF_VERSION, t as SERVER_NAME, u as groupRefsByMailbox, v as AppleMailError, w as OsascriptTimeoutError, x as MailBusyError, y as IndexUnavailableError } from "./server-D5S4dzq6.js";
|
|
2
2
|
export { AppleMailClient, AppleMailError, BUILD_INFO, IndexUnavailableError, MailBusyError, MailNotRunningError, MailboxMap, MessageNotFoundError, OsascriptTimeoutError, PlatformError, PreconditionError, ProtocolError, REF_VERSION, SERVER_NAME, SERVER_VERSION, SchemaDriftError, TccDeniedError, WritesDisabledError, assertStaticScript, createOsascriptRunner, createServer, decodeRef, encodeRef, groupRefsByMailbox, inspectFile, loadConfig, locateEnvelopeIndex, mapOsaError, registerTools, withBusyRetry };
|