@zyx1121/apple-messages-mcp
v0.2.0
Published
MCP server for Apple Messages — send and read iMessages via Claude Code
Maintainers
Readme
█████╗ ██████╗ ██████╗ ██╗ ███████╗ ███╗ ███╗███████╗███████╗███████╗
██╔══██╗██╔══██╗██╔══██╗██║ ██╔════╝ ████╗ ████║██╔════╝██╔════╝██╔════╝
███████║██████╔╝██████╔╝██║ █████╗ ██╔████╔██║█████╗ ███████╗███████╗
██╔══██║██╔═══╝ ██╔═══╝ ██║ ██╔══╝ ██║╚██╔╝██║██╔══╝ ╚════██║╚════██║
██║ ██║██║ ██║ ███████╗███████╗ ██║ ╚═╝ ██║███████╗███████║███████║
╚═╝ ╚═╝╚═╝ ╚═╝ ╚══════╝╚══════╝ ╚═╝ ╚═╝╚══════╝╚══════╝╚══════╝
█████╗ ██████╗ ███████╗███████╗
██╔══██╗██╔════╝ ██╔════╝██╔════╝
███████║██║ ███╗█████╗ ███████╗
██╔══██║██║ ██║██╔══╝ ╚════██║
██║ ██║╚██████╔╝███████╗███████║
╚═╝ ╚═╝ ╚═════╝ ╚══════╝╚══════╝@zyx1121/apple-messages-mcp
MCP server for Apple Messages — send and read iMessages via Claude Code.
Install
claude mcp add apple-messages -- npx @zyx1121/apple-messages-mcpPrerequisites
- macOS with Messages.app configured
- Node.js >= 18
- First run will prompt for Automation permission (System Settings > Privacy & Security > Automation)
- Reading messages requires Full Disk Access (System Settings > Privacy & Security > Full Disk Access)
Tools
| Tool | Description |
|------|-------------|
| messages_send | Send an iMessage to a phone number or email |
| messages_list_chats | List recent chats/conversations |
| messages_read | Read recent messages from a specific chat or contact |
| messages_search | Search messages by keyword |
| messages_delete | Delete a specific chat/conversation |
Examples
"Send 'hello' to +886912345678" → messages_send { to: "+886912345678", message: "hello" }
"Show my recent chats" → messages_list_chats {}
"Read messages from John" → messages_read { contact: "[email protected]" }
"Search for 'meeting'" → messages_search { query: "meeting" }
"Delete chat with +886912345678" → messages_delete { contact: "+886912345678" }Limitations
- macOS only (uses AppleScript via
osascriptandsqlite3) - Sending uses AppleScript — Messages.app must be running
- Reading/deleting uses
~/Library/Messages/chat.db— requires Full Disk Access - Deleting quits Messages.app temporarily to safely modify the database
License
MIT — read at your own risk
