carterlasalle/mac_messages_mcp

Overview

An MCP server that securely interfaces with the iMessage database via the Model Context Protocol (MCP), enabling LLMs to query and analyze iMessage conversations. Features include phone number validation, attachment processing, contact management, group chat handling, and support for sending/receiving messages.

Capabilities

• • stdio transport support
• • authentication support
• • database integration
• • github integration
• • mcp client integration

Best For

MCP server for secure iMessage database access, allowing LLMs to query and analyze conversations with message sending, contact filtering, and SMS/RCS fallback.

Decision Snapshot

• • GitHub stars: 269
• • Forks: 39
• • Source provenance count: 1
• • Active signal: Updated this week from lifecycle signals.
• • Last seen: 4/15/2026
• • Published: 3/17/2026

Installation / Setup

uvx mac-messages-mcp

This is an MCP Find-authored example config generated from strong evidence.

Final parameters should follow the tool's official setup documentation.

{
  "mcpServers": {
    "macmessagesmcp": {
      "command": "uvx",
      "args": [
        "mac-messages-mcp"
      ]
    }
  }
}

Usage

{ && "mcpServers": { && "messages": { && "command": "uvx",

Features

• • **Universal Message Sending**: Automatically sends via iMessage or SMS/RCS based on recipient availability
• • **Smart Fallback**: Seamless fallback to SMS when iMessage is unavailable (perfect for Android users)
• • **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)
• • stdio transport support

Use Cases

• • Supports capabilities such as: stdio transport support; authentication support; database integration.
• • Common usage themes: mcp, curated, markdown-list, awesome-mcp-servers-punkpeye.

Supported Clients / Integrations

• • stdio transport support
• • authentication support
• • database integration
• • github integration
• • mcp client integration

Compatibility Signals

• • GitHub: supports (Detected in parser config/capability hints.)

Prompt Examples

Notes / Requirements

• • Primary language: Python
• • License: MIT
• • Parser coverage score: 1.00
• • Source feeds: Awesome MCP Servers (punkpeye)
• • Topic cluster: data-infra

Official Links

• Website
• Repository

Source Information

Related MCP Tools