mac_messages_mcp

An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.

GitHub Stars

163

User Rating

Not Rated

Favorites

0

Views

525

Forks

18

Issues

8

Installation
Difficulty
Beginner
Estimated Time
5-10 minutes

Installation

Installation

Prerequisites

macOS: 11 or higher
Python: 3.10 or higher
uv package manager

Installing uv

If you're on Mac, install uv using Homebrew:
bash
brew install uv
Otherwise, follow the installation instructions on the [uv website](https://github.com/astral-sh/uv). ⚠️ Do not proceed before installing uv

Installation Steps

Full Disk Access Permission

This application requires Full Disk Access permission for your terminal or application to access the Messages database. To grant Full Disk Access:
1Open System Preferences/Settings > Security & Privacy/Privacy > Full Disk Access
2Click the lock icon to make changes
3Add your terminal app (Terminal, iTerm2, etc.) or Claude Desktop/Cursor to the list
4Restart your terminal or application after granting permission.