Search and read Apple Messages — chats and decoded text, sending off by default
Connect Runs on your machine
claude mcp add mcp-apple-messages -e APPLE_MESSAGES_ALLOW_WRITES=<APPLE_MESSAGES_ALLOW_WRITES> -e APPLE_MESSAGES_ALLOW_CODES=<APPLE_MESSAGES_ALLOW_CODES> -e APPLE_MESSAGES_ALLOW_FILE_SEND=<APPLE_MESSAGES_ALLOW_FILE_SEND> -- npx -y @mgcrea/[email protected]{
"mcpServers": {
"mcp-apple-messages": {
"command": "npx",
"args": [
"-y",
"@mgcrea/[email protected]"
],
"env": {
"APPLE_MESSAGES_ALLOW_WRITES": "<APPLE_MESSAGES_ALLOW_WRITES>",
"APPLE_MESSAGES_ALLOW_CODES": "<APPLE_MESSAGES_ALLOW_CODES>",
"APPLE_MESSAGES_ALLOW_FILE_SEND": "<APPLE_MESSAGES_ALLOW_FILE_SEND>"
}
}
}
}{
"mcpServers": {
"mcp-apple-messages": {
"command": "npx",
"args": [
"-y",
"@mgcrea/[email protected]"
],
"env": {
"APPLE_MESSAGES_ALLOW_WRITES": "<APPLE_MESSAGES_ALLOW_WRITES>",
"APPLE_MESSAGES_ALLOW_CODES": "<APPLE_MESSAGES_ALLOW_CODES>",
"APPLE_MESSAGES_ALLOW_FILE_SEND": "<APPLE_MESSAGES_ALLOW_FILE_SEND>"
}
}
}
}{
"servers": {
"mcp-apple-messages": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/[email protected]"
],
"env": {
"APPLE_MESSAGES_ALLOW_WRITES": "<APPLE_MESSAGES_ALLOW_WRITES>",
"APPLE_MESSAGES_ALLOW_CODES": "<APPLE_MESSAGES_ALLOW_CODES>",
"APPLE_MESSAGES_ALLOW_FILE_SEND": "<APPLE_MESSAGES_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_MESSAGES_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_MESSAGES_ALLOW_CODESOptional | Register apple_messages_find_codes, which reads one-time codes out of recent messages. Its own gate rather than allowWrites: it is a read, and the one read most worth an explicit decision. |
APPLE_MESSAGES_ALLOW_FILE_SENDOptional | Let apple_messages_send_message attach a local file. Off by default even with writes on, because a path argument is a way to send anything the server can read. |
Details
| Package | @mgcrea/[email protected] (NPM, stdio) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | io.github.mgcrea/mcp-apple-messages |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.