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
119
2,248
TypeScript
MIT License
iMCP
mattt
-
security
A
license
-
quality
A macOS app that provides an MCP server to your Messages, Contacts, and more
Last updated -
742
MIT License
Apple MCP
zackbissell
-
security
A
license
-
quality
A collection of Apple-native tools for the MCP protocol that enables AI assistants to interact with Apple applications including Messages, Notes, Contacts, Mail, Reminders, Calendar, and Maps.
Last updated -
119
TypeScript
MIT License
KaitoMCPServer
yang-han
-
security
F
license
-
quality
A Python-based MCP server that uses uv for dependency management, requiring Python 3.13+ to run.
Last updated -
Python

View all related MCP servers

mac-messages-mcp