@griches/apple-messages-mcp
v1.0.0
Published
MCP server for interacting with Apple Messages on macOS
Downloads
67
Maintainers
Readme
@griches/apple-messages-mcp
An MCP server that gives AI assistants access to Apple Messages on macOS. Reads messages from the Messages database (SQLite) and sends messages via AppleScript.
Quick Start
npx @griches/apple-messages-mcpTools
| Tool | Description |
|------|-------------|
| list_chats | List recent chats with last message preview |
| get_chat_messages | Get message history for a specific chat (with optional date range filtering) |
| search_messages | Search messages by text content |
| send_message | Send an iMessage or SMS |
| get_chat_participants | Get participants of a chat |
Configuration
Claude Code
claude mcp add apple-messages -- npx @griches/apple-messages-mcpClaude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"apple-messages": {
"command": "npx",
"args": ["@griches/apple-messages-mcp"]
}
}
}Requirements
- macOS (uses AppleScript and macOS Messages database)
- Node.js 22+ (uses built-in
node:sqlite) - Full Disk Access granted to your terminal app (System Settings > Privacy & Security > Full Disk Access) — required for reading the Messages database
Permissions
- Reading messages: Requires Full Disk Access for your terminal app to read
~/Library/Messages/chat.db - Sending messages: macOS will prompt you to allow your terminal app to control the Messages app via AppleScript
License
MIT — see the main repository for full details.
