Mac-Nachrichten-MCP

Mac-Nachrichten MCP

Eine Python-Brücke für die Interaktion mit der macOS-Nachrichten-App unter Verwendung von MCP (Multiple Context Protocol).

$ein Diagramm eines Mac-Computers mit dem Tex\_FvvnmbaBTFeKy6F2GMlLqA\_IfCBMgJARcia1WTH7FaqwA$

Merkmale

Lesen Sie aktuelle Nachrichten aus der macOS-Nachrichten-App
Nachrichten nach Kontakt filtern
Senden Sie neue Nachrichten über iMessage
Zugriff auf Nachrichten über eine API

Voraussetzungen

macOS (getestet auf macOS 11+)
Python 3.10+
UV-Paketmanager

UV installieren

Wenn Sie einen Mac verwenden, installieren Sie uv mit Homebrew:

brew install uv

Andernfalls folgen Sie den Installationsanweisungen auf der UV-Website .

⚠️ Fahren Sie nicht fort, bevor Sie uv installiert haben

Installation

Volle Festplattenzugriffsberechtigung

⚠️ Diese Anwendung erfordert die Berechtigung „Voller Festplattenzugriff“ für Ihr Terminal oder Ihre Anwendung, um auf die Nachrichtendatenbank zuzugreifen.

So gewähren Sie vollständigen Festplattenzugriff:

Öffnen Sie Systemeinstellungen/Einstellungen > Sicherheit und Datenschutz/Datenschutz > Vollständiger Festplattenzugriff
Klicken Sie auf das Schlosssymbol, um Änderungen vorzunehmen
Fügen Sie Ihre Terminal-App (Terminal, iTerm2 usw.) oder Claude Desktop/Cursor zur Liste hinzu
Starten Sie Ihr Terminal oder Ihre Anwendung neu, nachdem Sie die Berechtigung erteilt haben

Integration

Claude Desktop Integration

Gehen Sie zu Claude > Einstellungen > Entwickler > Konfiguration bearbeiten > claude_desktop_config.json
Fügen Sie die folgende Konfiguration hinzu:

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

Cursor-Integration

Gehen Sie zu Cursoreinstellungen > MCP und fügen Sie dies als Befehl ein:

uvx mac-messages-mcp

⚠️ Führen Sie nur eine Instanz des MCP-Servers aus (entweder auf Cursor oder Claude Desktop), nicht beide

Option 1: Von PyPI installieren

uv pip install mac-messages-mcp

Option 2: Von der Quelle installieren

# Clone the repository
git clone https://github.com/carterlasalle/mac_messages_mcp.git
cd mac_messages_mcp

# Install dependencies
uv install -e .

Verwendung

Als Modul

from mac_messages_mcp import get_recent_messages, send_message

# Get recent messages
messages = get_recent_messages(hours=48)
print(messages)

# Send a message
result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!")
print(result)

Als Befehlszeilentool

# Run the MCP server directly
mac-messages-mcp

Entwicklung

Versionierung

Dieses Projekt verwendet semantische Versionierung. Weitere Informationen zur Funktionsweise des Versionssystems und zur Veröffentlichung neuer Versionen finden Sie in VERSIONING.md .

So erhöhen Sie die Version:

python scripts/bump_version.py [patch|minor|major]

Sicherheitshinweise

Diese Anwendung greift direkt auf die Nachrichtendatenbank zu, die persönliche Nachrichten enthält. Bitte verwenden Sie sie verantwortungsvoll und stellen Sie sicher, dass Sie über die entsprechenden Berechtigungen verfügen.

Lizenz

MIT

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Sternengeschichte

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Eine Python-Bridge für die Interaktion mit der macOS-Nachrichten-App über MCP (Multiple Context Protocol). Einfache Installation mit uvx mac-messages-mcp

Related Resources

Reddit Discussion about this server

Related MCP Servers

Apple MCP Server
supermemoryai
A
security
A
license
A
quality
Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Last updated -
6
506
1,999
TypeScript
MIT License
YaVendió Toolsofficial
YaVendio
-
security
-
license
-
quality
An MCP-based messaging system that allows AI systems to interact with various messaging platforms through standardized tools for sending text, images, documents, buttons, and alerts.
Last updated -
Python
MCP Python Server
jatindera
-
security
F
license
-
quality
A Python-based implementation of the Model Context Protocol that enables communication between a model context management server and client through a request-response architecture.
Last updated -
Python
iMCP
loopwork
-
security
A
license
-
quality
A macOS app that provides an MCP server to your Messages, Contacts, and more
Last updated -
642
Apache 2.0

View all related MCP servers

mac-messages-mcp