Search, read and act on Apple Mail — threads, attachments, body search, writes off by default
Connect Runs on your machine
claude mcp add mcp-apple-mail -e APPLE_MAIL_ALLOW_WRITES=<APPLE_MAIL_ALLOW_WRITES> -e APPLE_MAIL_ACCOUNTS=<APPLE_MAIL_ACCOUNTS> -e APPLE_MAIL_ALLOW_FILE_SEND=<APPLE_MAIL_ALLOW_FILE_SEND> -- npx -y @mgcrea/[email protected]{
"mcpServers": {
"mcp-apple-mail": {
"command": "npx",
"args": [
"-y",
"@mgcrea/[email protected]"
],
"env": {
"APPLE_MAIL_ALLOW_WRITES": "<APPLE_MAIL_ALLOW_WRITES>",
"APPLE_MAIL_ACCOUNTS": "<APPLE_MAIL_ACCOUNTS>",
"APPLE_MAIL_ALLOW_FILE_SEND": "<APPLE_MAIL_ALLOW_FILE_SEND>"
}
}
}
}{
"mcpServers": {
"mcp-apple-mail": {
"command": "npx",
"args": [
"-y",
"@mgcrea/[email protected]"
],
"env": {
"APPLE_MAIL_ALLOW_WRITES": "<APPLE_MAIL_ALLOW_WRITES>",
"APPLE_MAIL_ACCOUNTS": "<APPLE_MAIL_ACCOUNTS>",
"APPLE_MAIL_ALLOW_FILE_SEND": "<APPLE_MAIL_ALLOW_FILE_SEND>"
}
}
}
}{
"servers": {
"mcp-apple-mail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/[email protected]"
],
"env": {
"APPLE_MAIL_ALLOW_WRITES": "<APPLE_MAIL_ALLOW_WRITES>",
"APPLE_MAIL_ACCOUNTS": "<APPLE_MAIL_ACCOUNTS>",
"APPLE_MAIL_ALLOW_FILE_SEND": "<APPLE_MAIL_ALLOW_FILE_SEND>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
APPLE_MAIL_ALLOW_WRITESOptional | Register the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them. |
APPLE_MAIL_ACCOUNTSOptional | Restrict every read and write to these Mail accounts, by name. Bounds reading, not just writing. |
APPLE_MAIL_ALLOW_FILE_SENDOptional | Let the compose tools attach a local file and send in the same call. Attaching to a draft needs only writes; this is off by default because an immediate send puts the file in someone's inbox with nobody reviewing it. |
Details
| Package | @mgcrea/[email protected] (NPM, stdio) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | io.github.mgcrea/mcp-apple-mail |
More search and web servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.