mac_messages_mcp | SkillsLLM
Home MCP Servers 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.
applescript claude contacts cursor imessage
# Add to your Claude Code skills
git clone https://github.com/carterlasalle/mac_messages_mcpMac Messages MCP
A Python bridge for interacting with the macOS Messages app using MCP (Multiple Context Protocol).
<a href="https://glama.ai/mcp/servers/gxvaoc9znc">
<img width="380" height="200" src="https://glama.ai/mcp/servers/gxvaoc9znc/badge" />
</a>
Quick Install
For Cursor Users
Click the button above to automatically add Mac Messages MCP to Cursor
For Claude Desktop Users
See the Integration section below for setup instructions.
Features
Universal Message Sending : Automatically sends via iMessage or SMS/RCS based on recipient availabilitySmart Fallback : Seamless fallback to SMS when iMessage is unavailable (perfect for Android users)Message Reading : Read recent messages from the macOS Messages appContact Filtering : Filter messages by specific contacts or phone numbers
mac
macos
mcp
mcp-server
Fuzzy Search : Search through message content with intelligent matching
iMessage Detection : Check if recipients have iMessage before sending
Cross-Platform : Works with both iPhone/Mac users (iMessage) and Android users (SMS/RCS)
Prerequisites
macOS (tested on macOS 11+)
Python 3.10+
uv package manager
Installing uv If you're on Mac, install uv using Homebrew:
Otherwise, follow the installation instructions on the uv website .
⚠️ Do not proceed before installing uv
Installation
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:
Open System Preferences/Settings > Security & Privacy/Privacy > Full Disk Access
Click the lock icon to make changes
Add your terminal app (Terminal, iTerm2, etc.) or Claude Desktop/Cursor to the list
Restart your terminal or application after granting permission
Integration
Claude Desktop Integration
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json
Add the following configuration:
{
"mcpServers": {
"messages": {
"command": "uvx",
"args": [
"mac...
