Mac_messages_mcp

Name: Mac_messages_mcp
Author: carterlasalle

mcp-proxy · by carterlasalle

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.

279 1.6M/wk 4 tools GitHub npm PyPI

No known CVEs

MIT license

Actively maintained

Last commit 8d ago

Works with most clients

Transport: stdio

4 tools · ~418 tok

Grade A · 0.2% of 200K ctx

Edit this pageView history

Communication

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

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

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/mac-messages-mcp)](https://mcppedia.org/s/mac-messages-mcp)

Read me

What Mac_messages_mcp does

A Python bridge for interacting with the macOS Messages app using MCP (Multiple Context Protocol).

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y 'mcp-proxy' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

95/100across 5 weighted dimensions

How we score →

0255075100

−5

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked mcp-proxy against OSV.dev.

Inventory

Tools (4)

Click any tool to inspect its schema.

~418 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Mac_messages_mcp safe to use?: Mac_messages_mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install Mac_messages_mcp?: Mac_messages_mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Mac_messages_mcp do?: Mac_messages_mcp provides 4 tools: send_message, get_recent_messages, check_imessage_availability, search_messages. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Mac_messages_mcp?: Mac_messages_mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is Mac_messages_mcp actively maintained?: Mac_messages_mcp is actively maintained — last commit was 8 days ago. It has 279 GitHub stars.

Similar servers

Others in communication

View all →

Mcp_agent_mail94

Asynchronous coordination layer for AI coding agents: identities, inboxes, searchable threads, and advisory file leases over FastMCP + Git + SQLite

2.0k 6

Autotask Mcp93

MCP server for Kaseya Autotask PSA — 39 tools for companies, tickets, projects, time entries, and more

36 7

Agenticmail92

Email & SMS infrastructure for AI agents — send and receive real email and text messages programmatically

126 7

Ntfy Mcp Server91

An MCP (Model Context Protocol) server designed to interact with the ntfy push notification service. It enables LLMs and AI agents to send notifications to your devices with extensive customization options.

16 1

MCP Security Weekly

Get CVE alerts and security updates for Mac_messages_mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

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

Group Chat Filtering: Use chat IDs from tool_get_chats to read one group conversation chronologically

Fuzzy Search: Search through message content with intelligent matching

Attachments: Find and view photos, PDFs, and other attachments shared in conversations

iMessage Detection: Check if recipients have iMessage before sending

Cross-Platform: Works with both iPhone/Mac users (iMessage) and Android users (SMS/RCS)

Working with attachments

Attachment access uses progressive disclosure — discovery is cheap, fetching is deliberate:

Tier 1 — discovery in message search. tool_get_recent_messages and tool_fuzzy_search_messages annotate messages that have attachments with a compact summary like [attachments: #42 image/jpeg (invitation.jpg)]. The id lets you fetch the file later.

Tier 2 — attachment-first search. tool_search_attachments(start_date, end_date, contact, mime_type, limit) returns metadata only (id, MIME type, filename, size, sender) — useful for "find all images Elizabeth sent in April 2026" without scanning message text.

Tier 3 — fetch. tool_get_attachment(attachment_id) returns the file. Image MIME types come back inline (HEIC is converted to PNG so it can be viewed directly). PDFs, video, and audio come back as a filesystem path the agent can read with its own tools. Inline image bytes are capped at 5MB by default to avoid context blowup; oversized images fall back to path return.

Stickers, link-preview "balloon" payloads, and .pluginPayloadAttachment containers are filtered out by default.

Recipient formats

For direct sends, E.164 phone numbers with a leading + are the most reliable format, such as +14155551234. Bare digit phone numbers with a country code are normalized before sending, and 10-digit US numbers are sent as +1.... tool_find_contact returns phone matches in the same send-ready format.

Frequently Asked Questions

Is Mac_messages_mcp safe to use?

Mac_messages_mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install Mac_messages_mcp?

Mac_messages_mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Mac_messages_mcp do?

Mac_messages_mcp provides 4 tools: send_message, get_recent_messages, check_imessage_availability, search_messages. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Mac_messages_mcp?

Mac_messages_mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is Mac_messages_mcp actively maintained?

Mac_messages_mcp is actively maintained — last commit was 8 days ago. It has 279 GitHub stars.