mac-messages-mcp

mac-messages-mcp

A Python MCP server bridging macOS Messages with MCP for cross-platform messaging.

184
Stars
23
Forks
0
Releases

Overview

Mac Messages MCP is a Python-based MCP server that provides programmatic access to the macOS Messages app via the MCP protocol. It enables universal message delivery across iMessage and SMS/RCS by automatically selecting the appropriate channel for each recipient and providing a smart fallback when iMessage is unavailable. The server can read recent conversations from the macOS Messages database, filter messages by contacts or phone numbers, and perform fuzzy, content-aware searches. It detects iMessage availability before sending and supports delivery to both iPhone/Mac users (iMessage) and Android users (SMS/RCS). Prerequisites include macOS (tested on macOS 11+), Python 3.10+, and uv, with a requirement for Full Disk Access to access the Messages database. Integration options are provided for Claude Desktop and Cursor, as well as a Docker/Proxy path via mcp-proxy for containerized setups. The project offers a CLI tool and supports installation from PyPI or via source, making deployment flexible for local and integrated workflows.

Details

Owner
carterlasalle
Language
Python
License
MIT License
Updated
2025-12-07

Features

Universal Message Sending

Automatically routes messages via iMessage or SMS/RCS depending on recipient availability.

Smart Fallback

Seamless fallback to SMS when iMessage is unavailable.

Message Reading

Read recent messages from the macOS Messages app.

Contact Filtering

Filter messages by specific contacts or phone numbers.

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).

Audience

Claude DesktopIntegrate MCP with Claude Desktop to access, query, and analyze macOS Messages data.
Cursor usersOne-click install to run the MCP server in Cursor for seamless message access.
DevelopersInstall, run, and contribute to the MCP server to enable messaging capabilities.

Tags

macOSMessagesMCPiMessageSMSRCSCross-PlatformContact FilteringFuzzy SearchMessage ReadingPythonCLIDocker