Mac Messages MCP

stdionone★ 291communication

A Python bridge for interacting with the macOS Messages app.

Install

How to run this server

[ { "cmd": "npx mcp-proxy", "imports": [] } ]

server path: mac-messages-mcp

Tools

What this server exposes

tool_get_recent_messages

Read recent messages from the macOS Messages app, with optional contact filtering and attachment discovery

tool_fuzzy_search_messages

Search through message content with intelligent matching, annotating messages that have attachments

tool_search_attachments

Search attachments by date range, contact, MIME type, and limit, returning metadata only

tool_get_attachment

Fetch a specific attachment by ID, returning inline images or file paths for other types

tool_find_contact

Find a contact by name or phone number, returning phone matches in send-ready format

tool_get_chats

Get chat IDs for group conversations to read one group chat chronologically

Configuration

Environment & auth

authnone

envMCP_MESSAGES_URL

Resources