Communication · OS Automation

mac_messages_mcp logo

mac_messages_mcp

carterlasalle/mac_messages_mcp

Use Claude, Codex, Cursor, VS Code, or any local MCP client to search, read, and send messages through the macOS Messages app.

Install

uvx mac-messages-mcp

Client configuration

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

Environment variables

MAC_MESSAGES_REGION
GitHub stars
68
Category
Communication, OS Automation
License
MIT
Updated
Oct 6, 2026

About mac_messages_mcp

Mac Messages MCP runs locally on your Mac. It opens the Messages and Contacts databases read-only, returns only the data a client asks for, and uses Messages.app automation only when the client explicitly calls the send tool.

Features

  • Read recent messages across all conversations or filter by contact or group chat

  • Fuzzy-search message text across a time window, including all available history

  • Find Contacts by approximate name and return send-ready phone numbers

  • List named group chats and use their chat IDs for reads or sends

  • Send iMessage, with SMS/RCS fallback for eligible phone recipients

  • Check whether a recipient appears reachable through iMessage before sending

  • Find attachments by date, sender, and MIME type

  • Return small images inline, convert HEIC images to PNG, or return a local path for larger and non-image files

  • Diagnose Messages and Contacts database permissions from inside the MCP client

Tools (11)

  • tool_get_recent_messages

    Read recent messages, optionally filtered by contact or group chat ID

  • tool_fuzzy_search_messages

    Search message bodies by approximate text match; defaults to 30 days, or use hours=0 for all history

  • tool_find_contact

    Fuzzy-match a name in Contacts and return phone numbers

  • tool_get_chats

    List named group chats and their identifiers

  • tool_search_attachments

    Find attachment metadata by date, contact, MIME type, and limit

  • tool_get_attachment

    Fetch one attachment by ID, inline when supported or as a local path

  • tool_check_imessage_availability

    Check likely iMessage availability for a phone number or email

  • tool_check_db_access

    Diagnose access to ~/Library/Messages/chat.db

  • tool_check_contacts

    Return a contact count and a small sample

  • tool_check_addressbook

    Diagnose Contacts/AddressBook database access

  • tool_send_message

    Send one direct or group message through Messages.app

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux
VS Code GitHub Copilot logo

VS Code GitHub Copilot

Desktop · Freemium · MIT

VS Code integrates MCP with GitHub Copilot through agent mode, allowing direct interaction with MCP-provided tools in your agentic coding workflow. Configure servers in Claude Desktop, workspace, or user settings, with guided MCP installation and secure handling of secrets in input variables to avoid leaking hardcoded keys.

WindowsMacOSLinuxWeb

Related MCP servers

More servers
Inbox Zero AI MCP logo

Inbox Zero AI MCP

elie222/inbox-zero

7.1k

To help you spend less time in your inbox, so you can focus on what matters most.

Communication
whatsapp logo

whatsapp

lharries/whatsapp-mcp

3.6k

This is a Model Context Protocol (MCP) server for WhatsApp.

Communication
Apple MCP Server logo

Apple MCP Server

Dhravya/apple-mcp

1.5k

Apple MCP toolset is a collection of Apple native tools based on the MCP protocol, providing integration services for Messages, Notes, Contacts, Mail, Reminders, Calendar and other Apple ecosystem features.

Communication
supergateway logo

supergateway

supercorp-ai/supergateway

1.1k

Supergateway runs MCP stdio-based servers over SSE (Server-Sent Events) or WebSockets (WS) with one command. This is useful for remote access, debugging, or connecting to clients when your MCP server only supports stdio.

Communication
Line Bot MCP Server logo

Line Bot MCP Server

line/line-bot-mcp-server

338

Model Context Protocol (MCP) server implementation that integrates the LINE Messaging API to connect an AI Agent to the LINE Official Account.

Communication
MCP Send Email logo

MCP Send Email

resend/mcp-send-email

325

Connect your AI agent to the Resend platform. Send and receive emails, manage contacts, broadcasts, domains, and more, directly from any MCP client like Claude, Cursor, or Claude Code.

Communication