{"_id":"@mgcrea/mcp-apple-mail","_rev":"28-7f593ebff1c82fd0a2f8b44b8f00a504","name":"@mgcrea/mcp-apple-mail","dist-tags":{"bootstrap":"0.0.0-bootstrap","latest":"1.24.1"},"versions":{"0.0.0-bootstrap":{"name":"@mgcrea/mcp-apple-mail","version":"0.0.0-bootstrap","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@0.0.0-bootstrap","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/mcp-cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"ca444c60876613d122fa93f12ddc59ff9b0f1455","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-0.0.0-bootstrap.tgz","fileCount":11,"integrity":"sha512-n7dScQiRY3jwECio1GEK14IrGEwJhjqQNa6z66lcixg/O9S07wNSsWUIOG9eEu0oOAPQ3FMpd/qTfhrlQOk9Og==","signatures":[{"sig":"MEYCIQD7oA19IEBzKYfmVQYCl4aXYwMd1pYu2g+EJUPZ5nrt3wIhAPsPCi1Z+HAK5TeNEPJf1P6Gp2pu5CBOQLvaBo+NCuPg","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":424059},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"mgcrea","email":"olivier@mg-crea.com"},"repository":{"url":"git+https://github.com/mgcrea/mcp-cupertino.git","type":"git","directory":"packages/mail"},"description":"Model Context Protocol server for the macOS Apple Mail app","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.1.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_0.0.0-bootstrap_1787408914481_0.2711921528777441","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.3.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.3.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/mcp-cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"092e239137c605dd7cb31ae04b5a3a42ddbf7ccc","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.3.0.tgz","fileCount":11,"integrity":"sha512-62LWFCn2SlOccFIpN/hK/qjvO9CQO40wcyYRUY3xpyrJBqsHSqYivNlsl3n/XNnTQirdWm+AfokkQk6giI6crw==","signatures":[{"sig":"MEUCIQC5EHdMAGcYdBJj+jqczRTtBvrJaZlZMZDrvwXFnOqfgAIgKDslrXdWIq0StDjGhm7ffGwFL5rmBMrT7Z/knQN2lbs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":493223},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6db0f910-d2b7-4e03-8c2e-649bd4e5bd98"}},"repository":{"url":"git+https://github.com/mgcrea/mcp-cupertino.git","type":"git","directory":"packages/mail"},"description":"Model Context Protocol server for the macOS Apple Mail app","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.3.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.3.0_1787737276477_0.8741043123586327","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@mgcrea/mcp-apple-mail","version":"1.3.1","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.3.1","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/mcp-cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"49ad2899239b0d77be91797f53fdfe0788612774","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.3.1.tgz","fileCount":11,"integrity":"sha512-Z+a/2BKNLQHUuDXrAAefFYXW4f2nYZNU4hjybTZ4KufZclYb6SXngtz9VuLzZPxb6TrR6pMK7+VPzyNcWJSBNg==","signatures":[{"sig":"MEUCIAwkbV2NLFIq2DRqvVmqi2ZKZ1RtbvEYRvh7bS11VmIzAiEA0iql0jekl9wAiN3u3LmFKNfERxRoCR7bBjoxB9e1VSw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":522557},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6db0f910-d2b7-4e03-8c2e-649bd4e5bd98"}},"repository":{"url":"git+https://github.com/mgcrea/mcp-cupertino.git","type":"git","directory":"packages/mail"},"description":"Model Context Protocol server for the macOS Apple Mail app","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.3.1","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.3.1_1787840719812_0.4413642774213884","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.4.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.4.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/mcp-cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"2a1eb5785f147272aa85868d3a1a40525a54ee59","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.4.0.tgz","fileCount":11,"integrity":"sha512-gPvPCzn7F78+wVHgM5Ygz/yET7xOiOISysrr1h1c/2pDcxPi3BcdqeDg8MOX2oJgAAqaIQ9JoexYwuJmgWecSw==","signatures":[{"sig":"MEYCIQD0O1aSM5HVEPpA+isVLR9/ZrtKKbeh+oirh/jvzbRrXQIhAIfuATturXudYs97y1yI1Q6wqV9VTkzGHHQp8P9smlDD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":525299},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6db0f910-d2b7-4e03-8c2e-649bd4e5bd98"}},"repository":{"url":"git+https://github.com/mgcrea/mcp-cupertino.git","type":"git","directory":"packages/mail"},"description":"Model Context Protocol server for the macOS Apple Mail app","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.4.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.4.0_1788099071307_0.28584694771969943","host":"s3://npm-registry-packages-npm-production"}},"1.6.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.6.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.6.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"2d69224006762018b6203c08195d1e0cb23769e1","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.6.0.tgz","fileCount":11,"integrity":"sha512-dj+Tu8XGuXIPmgUSR4jKJDHTN/eq3OCZpNX4MN9Qc26PebspQDxj9kJeXhrSa3COUKIZiqCqHXYYmc0INh1PGQ==","signatures":[{"sig":"MEUCIQD785F8hZMkclOnmvZDwGnfBMD/k/QcWpSWKBUEVLPA/AIgZjLQyVCnTC1e6x/axudPjowHpx2KvuukSIqPMWj16bk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":528016},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Model Context Protocol server for the macOS Apple Mail app","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.6.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.6.0_1788253713193_0.0827265994213704","host":"s3://npm-registry-packages-npm-production"}},"1.7.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.7.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.7.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"480ee83373ed3829e77becca7c06f49982f176aa","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.7.0.tgz","fileCount":11,"integrity":"sha512-9Mb0b5Tw1lK+qR31bu4J140UO65eeFC8PKpgbEENQSoK9yo+0/IQZO9xxNHaoeYJP0ieVX5d2iT7bRbiJGgDjA==","signatures":[{"sig":"MEUCIDCq2+vnSFrgeOFJELuFhQynftknClIUR32P5u1NiuurAiEA7698xJGOlN8OUaXQFKYKIDv14AWjPow3d7JJ1jfd88Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.7.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":528771},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.7.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.7.0_1788267555754_0.8744689117261863","host":"s3://npm-registry-packages-npm-production"}},"1.8.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.8.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.8.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"8d0dfa96a3976e6a612c78b762d8f1a0a402de1b","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.8.0.tgz","fileCount":11,"integrity":"sha512-mDhAQtGscjPVqYdZOv8EHh9ilXI7i7OTBAMYUWjKfXmmKjWyKxySMRGRmAawubxqm2xjLWr/Kvn4l+b8AqWgyg==","signatures":[{"sig":"MEQCIH5PUXRkzOdFeklLEMotcyMJ3fsAlYb6t3M2iaza5bAdAiAbiIzvQLEME7y2ej6GlCnkmkpsgkyajm1xZDzDKUHvog==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.8.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":528771},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.8.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.8.0_1788291155623_0.27068743209864743","host":"s3://npm-registry-packages-npm-production"}},"1.9.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.9.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.9.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"e224a3f76bdd35bd685c9fbfec2665f80b7825a7","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.9.0.tgz","fileCount":11,"integrity":"sha512-KDZreppqblhgS+7BjQH1tPI78Y0kru/YfRltTVdoPTAF4xEsitsCrSBCrQIC2gtHkZuO+7B0KvdBGRAnmMO6Tw==","signatures":[{"sig":"MEQCIBmzsN9bfi4UIvpQrgxhybUBGAoc08hV5XXBxow3kNaVAiBMmfaoYWJ2074TGMc3/iJ8+XFhDKn8yevfd2uLfzPPbQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.9.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":528771},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.9.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.9.0_1788299832938_0.533615097126604","host":"s3://npm-registry-packages-npm-production"}},"1.10.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.10.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.10.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"e283953399822fef16520061f166f0ef5c77dfe8","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.10.0.tgz","fileCount":11,"integrity":"sha512-LWcbYEaslUxL35PBwa2uRqu4LUKILKcFH9yk7MkUBkm2EW0IFOv8RXlNz+lAyaAJMq5oSPXi57LIOrruQmESDg==","signatures":[{"sig":"MEYCIQCk1ARy52/ZpN5pmn2hY2gAhS+tFbXcpv2o4b2rbNwjLwIhAMhT4WlgzK4a48JTVDSl2DCOweMHhDWSrItrMYXZUipd","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.10.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":558186},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.10.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.10.0_1788382815050_0.16643861319900854","host":"s3://npm-registry-packages-npm-production"}},"1.11.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.11.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.11.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"ab3a4e5e82b53fa778badb260b1a1582051e6252","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.11.0.tgz","fileCount":11,"integrity":"sha512-neVsVCXHflB/n155LqH/NdAwOvysglJEOA/QbzM4aC78gORvJzLxWFQvwX0gJgxo5oVlF/wmzTKsc1bawu91zg==","signatures":[{"sig":"MEUCIQDO4kgqGaF3z5mXWH2qZxtO8NPVfdVF46I9xjH1nsOEyAIgJ83WBtpvJmfs0yfqrT+shpRxViM1ykAAbpQfrt9B5Fk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.11.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":558186},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.11.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.11.0_1788439941128_0.7831884801118123","host":"s3://npm-registry-packages-npm-production"}},"1.12.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.12.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.12.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"d634e4b2afbe55168afefafe8d51781d31e551c6","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.12.0.tgz","fileCount":11,"integrity":"sha512-JU0D6JMVzcUfrHsuN4KkDB0Op6T6tyJlSa+nwgG64r8pUzG2MLJAI/qISgjJpL/Z6NQoZ6Fv00PoqcKltez6rA==","signatures":[{"sig":"MEYCIQDoyzGeuD5gbQr09aNhZeIkFW7LdGnunsQb+P5ZcSKKGQIhAJCmdaH71xbegsEXX0awjob495xSC6ucOugVKUzEHS8V","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.12.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":558186},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.12.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.12.0_1788455613965_0.567030450050837","host":"s3://npm-registry-packages-npm-production"}},"1.13.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.13.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.13.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"af9cb28fa2ba6e5e9f9b0b890208871380275a86","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.13.0.tgz","fileCount":11,"integrity":"sha512-d4TLAW6YeK2umF8sDmUPn7QOyGGfi5//LJZTs3QE/H2S8JJ0tHBoExSK0DkEnbfZFwW7vfHfsb7vOuqiN5/Jew==","signatures":[{"sig":"MEYCIQDM8wMQeGQW8uXRiF/FFWnUDgQvr0/c3PLmbzBas6z+dAIhANe5nbwU+uKOhwl8yaL17/2dR7FaR4R23s+OQ8saWyWa","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.13.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":558313},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.13.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.13.0_1788524045922_0.5090352956060937","host":"s3://npm-registry-packages-npm-production"}},"1.14.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.14.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.14.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"d3e79e168d1294bd70494692bd379b3f7c5fa38d","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.14.0.tgz","fileCount":11,"integrity":"sha512-s0rgU/WO+Pvyi3juiOo5kH1awxPC0db0oWDbHi9+Lqi/J1gWbDCy30z5s5pefEhHuu/rSUacYjAhFdCfWbhqlg==","signatures":[{"sig":"MEQCICYVJbuESmFNpwCamhAgzl1ABr0kXPjxRAqKuw6DWvfxAiAG9yNdImniGt7/f6CVtkBVW5yrTKZQUjeupm0hObmS1w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.14.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":558313},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.14.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.14.0_1788557822640_0.3948679922780709","host":"s3://npm-registry-packages-npm-production"}},"1.15.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.15.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.15.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"8d646075b003422cbb1a2b0a2b5e8bb1f39cc750","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.15.0.tgz","fileCount":11,"integrity":"sha512-EKIHfvjQ6Bftn3tlFSqanpdO7m0+NCqOLqgnKSmOZLYmtwjGNW33uE40LQPc9vVAj82lA6drxbtAswFR4AVUPQ==","signatures":[{"sig":"MEYCIQDfvie9DJc9+uyDFkUOfrwKah/k3z6N5O3lrIGRnflJdQIhAJcztzJmGLFQ7sdUya3E1oXJYCpzB7klPG73i8cvE/+v","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.15.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":558918},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.15.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.15.0_1788648422145_0.1806621018106409","host":"s3://npm-registry-packages-npm-production"}},"1.16.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.16.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.16.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"d1f9fd4fd5bd7fdea37989d68110c0b89355466c","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.16.0.tgz","fileCount":11,"integrity":"sha512-NI+C+LPyqBa2/TR315r+Q+aDgpTuOl2DaOhspv5fetEr0ZDgoYNSSQrdU24C4iRXOFjKTWFyxuwnPvnHVWwtEQ==","signatures":[{"sig":"MEMCIHCy2tKZgIFJvPyWjYMd7bUXgZvw3OtGmOUz/R5M1+UmAh8oxIETy7BL+16ZTz+kF9CJUPTLmFlmpvpf7x61Eedj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.16.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":625298},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.16.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.16.0_1788691022454_0.6138304246650921","host":"s3://npm-registry-packages-npm-production"}},"1.17.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.17.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.17.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"c5cddeedf7341873387f61e3b84deac02b514772","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.17.0.tgz","fileCount":11,"integrity":"sha512-WNPooszvHLSULLJ9bLBIkEOVFoUKs9XTlJ2vffgKIW4UZHpRgHYQsJCCrA1f3MWbZAyhBoKUkIkeGCR468/f2A==","signatures":[{"sig":"MEUCIQCgGzuY+qNktMmNDH0Gs+p2I/iCGvxq4ilaxIlWDq86dgIgblcZbH9S/7hfTkTLEMSmjO9LwyYT2SvDUwXsuT/bDCA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.17.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":646182},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.17.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.17.0_1788793204335_0.582745379485268","host":"s3://npm-registry-packages-npm-production"}},"1.18.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.18.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.18.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"89a30590eb834dd554b32a372b4911dc6cb6502b","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.18.0.tgz","fileCount":11,"integrity":"sha512-Q8fE2n1i9YC4lcg816psTsD8mq+AEz2r3xwQrorPhUVTsYfh08OK/r7NoLttbMeSvkyNHzUOSiztdciTQknDwA==","signatures":[{"sig":"MEYCIQDvWUa4nSa+DFvm8gWvDfu30PvN9DD8KL+XPVs2f6FlqgIhAI6HLZDbvu60OnbmmXXktQg4ZWo1JW+8BNwmG/0mUdHh","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.18.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":646182},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.18.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.18.0_1788811600658_0.7518673351712204","host":"s3://npm-registry-packages-npm-production"}},"1.19.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.19.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.19.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"dca0ad9fa5260d579647df4c1265d126401b91e4","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.19.0.tgz","fileCount":11,"integrity":"sha512-98N84i6qFwfiMIu4xB9KgIuG1Q76IjTztCnFqXOYfXEXytn07Zrrm0sggFKkZp7TLYadvFXN4HROlm2z0mLskA==","signatures":[{"sig":"MEQCIFEbup0+zde6yDyhxypWKeR0h2e4b7jb5eUpiibiOd90AiAawqyy2K+wEk9c96wPiXfuPtExejYw55cgaq4Jm4dkyA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.19.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":646182},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.19.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.19.0_1788867851241_0.359061873175597","host":"s3://npm-registry-packages-npm-production"}},"1.19.1":{"name":"@mgcrea/mcp-apple-mail","version":"1.19.1","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.19.1","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"68b1801bb157fbd08279ec6c711b0b29d5fa049f","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.19.1.tgz","fileCount":11,"integrity":"sha512-NCCIaTXqOQFssHKW6t4voE1/ea50EdSwtFsjkt0p5VHUmQqMspf2/+N1lyRJmWeSv2ge9YKi1y16m4E5t8q2Fw==","signatures":[{"sig":"MEYCIQD1AvbTax/DgZ7VGevNr2D/05tgF8PxvOgEXiipxyyjtAIhAJTkxQbjFSluBvLyTBi67WtgnxTqmZT2RDTr+ApLA15H","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.19.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":646182},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.19.1","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.19.1_1788879483768_0.16539522857117706","host":"s3://npm-registry-packages-npm-production"}},"1.20.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.20.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.20.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"603cb56d5e38fce402842340ff4b4a2153aa325b","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.20.0.tgz","fileCount":11,"integrity":"sha512-Nski/zdutzeNDG5pFE9b4+pB3v5F2Iwa8NaRGnDrqA9yYH4cOcdStLszGrCbjGuPwo9MptRNWTPYBz34kW6+3Q==","signatures":[{"sig":"MEUCIQCUs4SYdfHEWPMgBRAJpG7YVNVBGApoqe4ayEK2N76tUwIgHvksV2C4zUBonEHFx7p1TYByoD7V1iz1yGZ2dpOrEN8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.20.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":646182},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.20.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.20.0_1788901228216_0.4892767374709275","host":"s3://npm-registry-packages-npm-production"}},"1.20.1":{"name":"@mgcrea/mcp-apple-mail","version":"1.20.1","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.20.1","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"978d0b1994f9ca5d98b985c1135eea1b0b6f53cc","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.20.1.tgz","fileCount":11,"integrity":"sha512-mMsiw+2QpbTFoEXtjF2DlJoz3IoVecZon9W6i8vXLD9XIkPc4zZAZGhYGsv2bo6vV5UpIdQ0rYFWatAKdrS8nQ==","signatures":[{"sig":"MEUCIALTcQ7TpRxmadLkJ8hHqsyEgaeWRWW8EnJeltdcw585AiEApDYIJNgwttzmM5qqcK1IxBL2RzY8K/nE/VpVg8e/hrM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.20.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":657611},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.20.1","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.20.1_1788953831513_0.12075063618312698","host":"s3://npm-registry-packages-npm-production"}},"1.21.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.21.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.21.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"431bbb5676b2c62d79e89bea620399ecdb229cfd","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.21.0.tgz","fileCount":11,"integrity":"sha512-xmS3NeKuaHcXLGwQLdFNOfid1WWYUgVnDdxKrJTOJqMX9jET1g/LP831WLJdB0VQLHqEKXKq/O1ATesOdV/zcw==","signatures":[{"sig":"MEYCIQCX02HvEpOS3o3VIrvuJFuS0OmeP7nNbLryCu5nfHjogQIhAM3cbi6/F99QgFVMDVk5MKM37VHdJM3lMV0UMyiy9mHf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.21.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":694548},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.21.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.21.0_1789052706882_0.6127145496796129","host":"s3://npm-registry-packages-npm-production"}},"1.21.1":{"name":"@mgcrea/mcp-apple-mail","version":"1.21.1","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.21.1","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"7963e61b76ce71185dab84f3b929bd8ea206bc93","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.21.1.tgz","fileCount":11,"integrity":"sha512-NnMgchE/Ua19pR+LsfB7sp1qXBKHIM5jXS1F5aARo7gY3hnk+wcT9giDCItXkXCl/6mRzY+Z/xMvMgGF8JxR/g==","signatures":[{"sig":"MEYCIQDZtF+mcKX+tfcfOe0T6GkhVeQbGXI614q+uuTqgLwKfgIhAOdJU4WiPeU5dnd2Fe9kKWdNN/PaeuF6G1Tj8bQXLr9Z","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.21.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":698808},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.21.1","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.21.1_1789159575917_0.8343643108717216","host":"s3://npm-registry-packages-npm-production"}},"1.22.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.22.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.22.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"7ab163cd7fafc277700feedd2652a224d8ca6190","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.22.0.tgz","fileCount":11,"integrity":"sha512-NYk/1e23y8QnfF7D+Z+NM3jaTWq+cJPYjzTNeGNc+9eo6W3/4cRBPmd1u9DRUIkqyQRUDQ4bDk//wdBcl+bT2g==","signatures":[{"sig":"MEQCIDokmzIjdrKaZ+I/eYU/LUgazzGjJGQgfkSLNbShsQdVAiB01hp6znz7zMkFD8g/ya2Krk38yfIbsDjIFSoCNezocA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.22.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":698808},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.22.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.22.0_1789551150955_0.5617400058351711","host":"s3://npm-registry-packages-npm-production"}},"1.22.1":{"name":"@mgcrea/mcp-apple-mail","version":"1.22.1","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.22.1","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"6753713139761cacaaa1ecd7a1aadcbf40ff3d70","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.22.1.tgz","fileCount":11,"integrity":"sha512-kiUCKgKwukKcqMfiT7Di/7O/zqMRAbARJ029lQdxmXIG4AFamKU5Mr7xmaZBtNzWdMP9h1XwSBvuIVRTC8wWWA==","signatures":[{"sig":"MEUCICpKMu90/hfuoZIH0MMwWc+/EJ5wcaJRUbBZrG+sNKE4AiEAg/xcsou2ixy93wk/109OzYylSG8l7OiErzy58xNVgFc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.22.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":698808},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.22.1","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.22.1_1789565066680_0.7230527716628226","host":"s3://npm-registry-packages-npm-production"}},"1.23.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.23.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.23.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"76f9140edc920766d37ac7f8c9717ae5cb88b9c3","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.23.0.tgz","fileCount":11,"integrity":"sha512-BTvGlwFXGLMN0c8u1FqOqYkyGh49ith1JLhFacG+aEWrnOOTUkMeralClrW7lR1JGEG+jvp/xdXun4AjVZbIKA==","signatures":[{"sig":"MEQCIAK2hFEOqaPlbcFBlrH1QiRIf6umlWVEWHyhYeHBQlsZAiBI8qg7dtY/64YmktmTItys81GkLfXKhPw2Hn03G/OFvw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIAr6NgMDJcRNmtOcU77Zk+ba1FFjXCmDYjZQ3McqPA+wAiEAlARGYSifZMEQaLGU9bOCfsTv7K9tlc10c48OLGZAC3c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.23.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":785151},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.20.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.23.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.23.0_1789809940607_0.9302195707758605","host":"s3://npm-registry-packages-npm-production"}},"1.24.0":{"name":"@mgcrea/mcp-apple-mail","version":"1.24.0","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"author":"Olivier Louvignes ","license":"MIT","_id":"@mgcrea/mcp-apple-mail@1.24.0","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"homepage":"https://cupertino.mgcrea.io","bugs":"https://github.com/mgcrea/cupertino/issues","os":["darwin"],"bin":{"apple-mail-mcp":"dist/cli.js"},"dist":{"shasum":"b9677440e357f3fcd615806b183bc5f69b45fcf7","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.24.0.tgz","fileCount":11,"integrity":"sha512-TguVjmby2lHAWg/kWS9ZcW/qT2RjtW6lHIApe51tZJpBJb+BYVUEZ1MLH/WJZemThJvsr5H+3dIZ9tNZoPURPA==","signatures":[{"sig":"MEYCIQCR2ZBoRL5jQrzkPVdEXTISDS9Tj7iFy7e8HErLeSQK4gIhAMwoCG/TEhotiuG+G7J4fxSaKcHbp5buPscnP87NCntp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIGrbFEmTlFjkYvjIcR9I+KwZTH+fJrrZN5/sYjxcFjxiAiBuOoQJPNq5N6/wai4n24JQ0hYK9MK3ekkVlTCST4fBqw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.24.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":785151},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.24.0","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-apple-mail_1.24.0_1790452500622_0.6701215757574985","host":"s3://npm-registry-packages-npm-production"}},"1.24.1":{"os":["darwin"],"_id":"@mgcrea/mcp-apple-mail@1.24.1","bin":{"apple-mail-mcp":"dist/cli.js"},"bugs":"https://github.com/mgcrea/cupertino/issues","dist":{"shasum":"0c4ca10872e704336cef990951ef9562146ef545","tarball":"https://registry.npmjs.org/@mgcrea/mcp-apple-mail/-/mcp-apple-mail-1.24.1.tgz","fileCount":11,"integrity":"sha512-tf5mXP+Rm4SdH01g+3CvMgtbLfXWpy33gzo1uJNxL470bgLTT5dCki27ShJ2u9/iclCAGndB+d+5bsORYJm2jg==","signatures":[{"sig":"MEQCIEl2BuMoO3IlhAkLhPlYbLGEYG/7fzQZT9ulGBgEMIARAiBFKMogWzhCDrTIgB9j7WtZ50edYkrJmQ+wqCs/8bsE0Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICPrqP8TE9FWsPKuJGkqiDQxfXsYYMH0Ys3l+dI7YO/+AiEA16Hoi6n+KkBDRO0VjnpBqsxPggHYcVNC0cOWXKqFZBo="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@mgcrea%2fmcp-apple-mail@1.24.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":785151},"main":"./dist/index.js","name":"@mgcrea/mcp-apple-mail","type":"module","types":"./dist/index.d.ts","author":"Olivier Louvignes ","engines":{"node":">=24"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"license":"MIT","mcpName":"io.github.mgcrea/mcp-apple-mail","scripts":{"dev":"tsdown --watch","test":"vitest run","build":"tsdown","start":"node dist/cli.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"version":"1.24.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"06373feb-a5ee-48b4-b0a9-f73d3bdd3770"}},"homepage":"https://cupertino.mgcrea.io","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","directories":{},"maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.4.3","@mgcrea/mcp-apple-core":"^1.24.1","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.11","vite":"^8.2.1","tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^7.0.2","@types/node":"^26.2.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-apple-mail_1.24.1_1790694173223_0.4622769556807482"}}},"time":{"created":"2026-08-22T14:28:34.346Z","modified":"2026-09-29T15:02:54.049Z","0.0.0-bootstrap":"2026-08-22T14:28:34.687Z","1.3.0":"2026-08-26T09:41:16.622Z","1.3.1":"2026-08-27T14:25:20.008Z","1.4.0":"2026-08-30T14:11:11.478Z","1.6.0":"2026-09-01T09:08:33.347Z","1.7.0":"2026-09-01T12:59:16.015Z","1.8.0":"2026-09-01T19:32:35.796Z","1.9.0":"2026-09-01T21:57:13.150Z","1.10.0":"2026-09-02T21:00:15.195Z","1.11.0":"2026-09-03T12:52:21.263Z","1.12.0":"2026-09-03T17:13:34.138Z","1.13.0":"2026-09-04T12:14:06.087Z","1.14.0":"2026-09-04T21:37:02.782Z","1.15.0":"2026-09-05T22:47:02.426Z","1.16.0":"2026-09-06T10:37:02.606Z","1.17.0":"2026-09-07T15:00:04.492Z","1.18.0":"2026-09-07T20:06:40.859Z","1.19.0":"2026-09-08T11:44:11.382Z","1.19.1":"2026-09-08T14:58:03.915Z","1.20.0":"2026-09-08T21:00:28.380Z","1.20.1":"2026-09-09T11:37:11.689Z","1.21.0":"2026-09-10T15:05:07.081Z","1.21.1":"2026-09-11T20:46:16.083Z","1.22.0":"2026-09-16T09:32:31.094Z","1.22.1":"2026-09-16T13:24:26.808Z","1.23.0":"2026-09-19T09:25:40.735Z","1.24.0":"2026-09-26T19:55:00.722Z","1.24.1":"2026-09-29T15:02:53.352Z"},"bugs":"https://github.com/mgcrea/cupertino/issues","author":"Olivier Louvignes ","license":"MIT","homepage":"https://cupertino.mgcrea.io","keywords":["apple","apple-mail","email","macos","mail","mcp","model-context-protocol"],"repository":{"url":"git+https://github.com/mgcrea/cupertino.git","type":"git","directory":"packages/mail"},"description":"Search, read and act on Apple Mail — threads, attachments, body search, writes off by default","maintainers":[{"name":"mgcrea","email":"olivier@mg-crea.com"}],"readme":"# @mgcrea/mcp-apple-mail\n\nModel Context Protocol server for the macOS **Apple Mail** app. Read, search and act on the mail\nthat is already synced to your Mac — no IMAP credentials, no OAuth, no mail leaving the machine.\n\n> **Unofficial.** Not affiliated with Apple. It drives the Mail app that is already on your Mac.\n\n## Status\n\nSearch, listing, counting, threading, body reading, body _search_ and every mutation are\nimplemented.\n\n## How it works\n\nApple Mail exposes two very different surfaces, and this server uses each for what it is good at.\nThe split is not a preference; it comes from measurements on a real 29,617-message mailbox:\n\n| Operation | Apple Events (AppleScript/JXA) | Verdict |\n| ------------------------------------------- | ------------------------------- | ------------- |\n| List 4 accounts + every mailbox | **0.6 s** | fine |\n| Mailbox total / unread count | 295 ms / 76 ms | fine |\n| Resolve one message by id in a 29 k mailbox | **0.10 s** | fine |\n| Fetch N messages, per field | ~130 ms + **42 ms per message** | usable to ~50 |\n| Read one property per message in a loop | ~250 ms each | never do this |\n| `messages whose read status is false` | **74 seconds** | unusable |\n\nSo searching cannot go through Apple Events at all. It has to read Mail's own SQLite index\n(`~/Library/Mail/V10/MailData/Envelope Index`), which is what Mail itself searches. That gives\nthree lanes:\n\n- **AppleScript lane** — accounts, mailboxes, counts, message-by-id, and every mutation. This is\n also the _authority_ lane: after a write, the result is what Mail re-read, never what the index\n says.\n- **Index lane** — read-only SQLite for search and filtering. Needs Full Disk Access.\n- **Body lane** — `.emlx` files on disk for message bodies and attachments. Needs Full Disk Access,\n and falls back to a per-message Apple Event.\n\nThe index is never written to. Mail owns it, holds it open, and reconciles it against IMAP; a write\nthere is corruption with a delay fuse.\n\n## Permissions\n\nTwo separate macOS permissions, doing different jobs. Neither is granted to Mail.app — it is the\n_reader_ that needs permission, not Mail.\n\n| Permission | Needed for | Without it |\n| --------------------- | ----------------------------------- | ------------------------------------------------------------------------------- |\n| **Automation → Mail** | everything | the server cannot do anything; you get a `-1743` error |\n| **Full Disk Access** | search, message bodies, attachments | the server still runs: accounts, mailboxes, counts and capped listings all work |\n\n**Automation** is granted to the app that launches the server (Terminal, iTerm, VS Code, Claude…).\nmacOS prompts for it on the first Apple Event, so usually you just click Allow.\n\n**Full Disk Access** is the awkward one.\n\n### Why you should not just grant it to your editor\n\nmacOS attributes a process's file access to its _responsible process_ — the app at the top of the\nlaunch chain. When Claude spawns this server the chain is:\n\n```\nlaunchd → Visual Studio Code.app → Code Helper → claude → node dist/cli.js\n```\n\nso the grant would have to go to **VS Code**, and with it every extension, task and terminal command\nthat editor ever runs would gain read access to your entire disk: Messages, Safari history, SSH\nkeys, other apps' containers. That is a much larger permission than \"may search my mail\", and it\ndefeats `APPLE_MAIL_ACCOUNTS`, which exists to bound exactly this.\n\nYou cannot avoid it by granting the permission to `.mcp.json` (it is data, not code) or to `node`\n(it is not the responsible process, and it is shared by every node program on the machine).\n\n### What to do instead\n\nInstall [**Cupertino.app**](https://cupertino.mgcrea.io), the signed menu bar app this package is\ndeveloped in. It holds one Full Disk Access grant and serves this server beneath it, so the\npermission belongs to a notarized binary rather than to your editor:\n\n```bash\nbrew install --cask mgcrea/tap/cupertino\n```\n\nMeasured: Full Disk Access and Automation granted to a signed `.app` are inherited two levels deep\nby the processes it spawns, so a `node` grandchild reads the Envelope Index and `tccd` resolves a\ngrandchild `osascript` to the app rather than to whatever launched it.\n\nEarlier versions of this package described a small compiled launcher that made itself its own\nresponsible process through a private API. It is no longer built or shipped — there is nothing left\nto escape — though `native/launcher.c` stays in the repository as the clearest statement of the\nproblem.\n\nIf you would rather not install the app, granting Full Disk Access to your editor does work. Read\nthe paragraph above about what that grant actually covers before you do.\n\nRestart your MCP host after granting. `apple_mail_diagnostics` reports which permission is missing\nand what it is blocking.\n\nA wrinkle worth knowing: `stat()` on a TCC-protected file **succeeds** — you can see the size and\nmtime of the index without Full Disk Access, and only reading it is denied. So \"the file is there\"\nis not evidence that the permission is granted; `access(R_OK)` is.\n\nThis install flow is a stopgap. [docs/distribution.md](../../docs/distribution.md) covers where it\ngoes next — a signed, notarized app so the grant survives updates and no one needs a compiler —\nand why the App Store cannot host any of it.\n\n## Quick start\n\n```bash\n# A. from npm\nnpx -y @mgcrea/mcp-apple-mail\n\n# B. from source\npnpm install && pnpm build && node dist/cli.js\n```\n\nWire it into Claude Code (`.mcp.json`) or Claude Desktop:\n\n```jsonc\n{\n \"mcpServers\": {\n \"apple-mail\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@mgcrea/mcp-apple-mail\"],\n \"env\": {\n // Off by default. With it off the write tools are not registered at all.\n \"APPLE_MAIL_ALLOW_WRITES\": \"0\",\n },\n },\n },\n}\n```\n\nInspect the tools directly:\n\n```bash\nnpx @modelcontextprotocol/inspector node dist/cli.js\n```\n\n## Tools\n\n| Tool | Does |\n| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |\n| `apple_mail_diagnostics` | What the server can currently do and why. **Call this first when anything looks wrong** — it names the exact System Settings pane to open. |\n| `apple_mail_list_accounts` | Accounts with UUIDs, addresses and mailbox names. Start here. |\n| `apple_mail_list_mailboxes` | Mailboxes, optionally with counts (~0.3 s each). |\n| `apple_mail_list_messages` | Newest N of one mailbox, with a `ref` per message. |\n| `apple_mail_search_messages` | Any combination of filters. `body` searches message text — see [Body search](#body-search). |\n| `apple_mail_count_messages` | Totals and unread, labelled by source. |\n\nEvery message carries an opaque `ref` (`m1:/#`) which the read and action\ntools take. It is versioned and carries its mailbox, so a row id can never be applied to the wrong\nmailbox. Do not construct one by hand.\n\n### Attachments\n\nMail almost always stores attachment bodies _outside_ the message file, in a sidecar tree — on a\nreal mail store, none of the attachments sampled were inline. So an attachment's size and whether it\ncan be fetched cannot be answered by parsing the message alone, and two plausible shortcuts are both\nwrong:\n\n- A non-empty MIME part does **not** mean the bytes are there. Stripping leaves a byte of delimiter\n whitespace behind, which reads as a present, 1-byte attachment.\n- `X-Apple-Content-Length` is **not** a byte size. It records the base64-encoded length, so a\n 164,156-byte PDF advertises 224,634.\n\n`list_attachments` therefore reports `sizeBytes` from the file on disk and a `retrievable` flag\nsaying whether `save_attachment` will actually succeed, rather than guessing from the message.\n\n## Security\n\n**Blast radius.** This server can read your entire mail archive and, with writes on, send mail as\nyou. Two independent controls:\n\n- `APPLE_MAIL_ALLOW_WRITES` (default off) gates every mutation. With it off the write tools are not\n registered — they are invisible to the model, not merely refused.\n- `APPLE_MAIL_ACCOUNTS` restricts which accounts are visible at all. This is the _read_-side\n control, and `ALLOW_WRITES` does not cover it. It is enforced in one place, so no query path can\n escape it.\n\nOnce implemented, sending will default to leaving a **draft** open for review; actually sending\nrequires both `ALLOW_WRITES` and an explicit `confirm: true`.\n\n**No secrets.** The server holds no credential of any kind — its access is the macOS permission you\ngranted the host app. There is nothing here to leak, and nothing is sent anywhere: no network calls\nare made at all.\n\n**Attachments.** `save_attachment` can only write inside `APPLE_MAIL_ATTACHMENT_DIR`, and the\nfilename is reduced to its basename first — a sender who names their attachment\n`../../../.ssh/authorized_keys` gets a file called `authorized_keys` in your downloads folder and\nnothing else. Existing files are never overwritten unless you ask.\n\n**No shell.** The one place this package spawns a process uses `execFile`, never `exec`, and no\ncaller input is ever interpolated into script text. Scripts are static constants piped to\n`osascript` over stdin; every value travels as a JSON argument. A mailbox named\n`\"; do shell script \"touch /tmp/pwned\"; //` is data, not syntax — there is a test for exactly that,\nand a tripwire that refuses to run any script containing a `${`.\n\n**Dependencies.** Two: the MCP SDK and zod. SQLite comes from `node:sqlite`, built into Node 24.\n\n## Configure\n\n| Variable | Default | Notes |\n| ---------------------------------- | ------------- | ------------------------------------------------------------------------------- |\n| `APPLE_MAIL_ALLOW_WRITES` | `0` | Register the mutating tools. |\n| `APPLE_MAIL_ACCOUNTS` | all | Comma-separated account names or UUIDs. |\n| `APPLE_MAIL_DEBUG` | off | Verbose logging to stderr. |\n| `APPLE_MAIL_INDEX_MODE` | `auto` | `auto` \\| `ro` \\| `immutable` \\| `off`. `off` disables the index lane entirely. |\n| `APPLE_MAIL_ROOT` | auto | Override Mail's data root. Normally discovered from Mail itself. |\n| `APPLE_MAIL_ENVELOPE_INDEX` | auto | Explicit index path, for tests and forensic copies. |\n| `APPLE_MAIL_OSASCRIPT_TIMEOUT_MS` | `30000` | Sized for the first-run permission prompt, which blocks. |\n| `APPLE_MAIL_DEGRADED_MAX_MESSAGES` | `50` | Cap for the Apple Events listing lane. |\n| `APPLE_MAIL_MAX_RESULTS` | `200` | Ceiling for search results. |\n| `APPLE_MAIL_BODY_MAX_BYTES` | `262144` | Body truncation, to protect the context window. |\n| `APPLE_MAIL_ATTACHMENT_DIR` | `~/Downloads` | The only directory attachments may be saved into. |\n| `APPLE_MAIL_MAILBOX_CACHE_TTL_MS` | `60000` | How long the account/mailbox map is cached. |\n\n## Notes\n\nThings that will bite you, documented so nobody has to rediscover them:\n\n- **`unread count` from Mail can be flatly wrong.** On this machine a mailbox reported\n `unreadCount = 0` while `messages whose read status is false` counted 1618 and Mail's own badge\n showed 37 — three numbers for one mailbox. It is a cached value. Counts are therefore reported\n with their source rather than merged.\n- **Gmail accounts keep everything in `[Gmail]/All Mail`.** INBOX membership is a _label_, so the\n obvious index query (`WHERE mailbox = ?`) returns an empty inbox. Mailbox names are resolved\n through a ladder that strips the `[Gmail]/` prefix.\n- **The on-disk layout nests too, and the ref cannot see it.** `All Mail` is not at\n `/All Mail.mbox` — it is at `/[Gmail].mbox/All Mail.mbox`, and a label like\n `Work/Projects` nests two deep. The index knows the full path, but the ladder above strips it\n down to the leaf before the ref is minted, so the file lane gets `All Mail` and nothing else.\n It therefore resolves the name by walking `*.mbox` directories under the account root (never\n into `Data/`) and, when a leaf name is ambiguous, picks the container that actually holds the\n rowid. A flat join here silently disabled every message-file capability on Gmail accounts.\n- **`existsSync` succeeds on a TCC-protected path.** It is stat-based, so it answers \"is it\n there\", not \"may I read it\" — `readdirSync` and `readFileSync` are the calls that return\n `EPERM`. Existence and readability are different questions, which is why\n `apple_mail_diagnostics` reads a byte of a real message file rather than statting it, and why\n a lookup can distinguish \"wrong path\" from \"no permission\" instead of blaming Full Disk Access\n for both.\n- **`immutable=1` is the wrong way to open the index**, even though it is the common advice. It\n tells SQLite to ignore the `-wal` file, and Mail runs in WAL mode, so a read can miss whatever has\n not been checkpointed yet — precisely the recent mail an agent is usually asked about. Note this\n is a race, not a certainty: probing both modes on a live 437 MB index with a 1 MB `-wal` present\n returned the _same_ `MAX(ROWID)`, because the newest message happened to be checkpointed already.\n `mode=ro` is the default because it removes the question, not because staleness was observed.\n- **Reading a message does not launch Mail.** If Mail is not running, read tools fail cleanly rather\n than launching it, because launching Mail steals focus and starts a sync.\n\n## Body search\n\n`search_messages` takes a `body` term, and it is the one filter with no index behind it.\n\nThere is nothing to index against. The Envelope Index carries no FTS table, and the Spotlight\nvolume index **excludes `~/Library` entirely** — `mdfind` returns nothing under that path however\nthe query is phrased, which is a fact about Spotlight's scope and not about mail. Mail's own body\nsearch runs on CoreSpotlight donations, queried through `CSSearchQuery` by the app that donated\nthem and unreachable from here. The measurements are in\n[docs/mail-body.md](../../docs/mail-body.md).\n\nSo the index narrows and the scan reads only the survivors. **Cost is linear in survivors**,\nmeasured at 0.48 ms per message on a 181,734-message store:\n\n| Candidates after the other filters | Cost |\n| ---------------------------------- | -------------- |\n| 100 — a tight filter | 48 ms |\n| 500 | 242 ms |\n| 1,932 — 90 days of one mailbox | 0.9 s |\n| 6,566 — 90 days, every mailbox | 3.2 s |\n| 182,329 — no filter at all | 88 s, unusable |\n\nWhich is why the bound is **declared, not hidden**. Over `APPLE_MAIL_BODY_SCAN_MAX` (2,000) the\nsearch returns `degraded` naming the candidate count and the bound, and scans nothing. A silent cap\nat the newest N messages would answer \"not found\" for older mail indistinguishably from a real\nabsence, and the model has no way to tell those apart; a refusal it can read, it can act on.\n\nTwo consequences worth knowing:\n\n- **Combine `body` with a narrowing filter.** `mailbox`, `sender`, `dateFrom` — any of them. A body\n search over a few hundred candidates is near-instant.\n- **The scan reads the first `APPLE_MAIL_BODY_SCAN_BYTES` (64 KB) of each file.** 79% of a real\n store's bytes are base64 that no text search would match, and MIME puts text parts ahead of\n attachments — so this trades a tail nothing wants for a cost paid on every candidate. A term\n hiding past the cap is missed; raise it if that matters more than latency.\n\n## Develop\n\n```bash\npnpm install\npnpm dev # tsdown --watch\npnpm test # vitest, fully offline\npnpm typecheck\npnpm lint && pnpm format:check\npnpm probe # the phase 0 spike (needs Full Disk Access)\n```\n\nTests are offline and hermetic: the process boundary is injected, so the queue, the injection\ntripwire and the envelope handling all run for real without spawning `osascript` or touching Mail.\n\n## License\n\nMIT\n","readmeFilename":""}