bluebubbles-mcp

MCP-Server für BlueBubbles — Zugriff auf iMessage von jedem MCP-Client aus.

Von Grund auf neu erstellt, ohne MCP-Abhängigkeiten von Drittanbietern außer dem offiziellen mcp SDK und httpx.

Voraussetzungen

Python 3.11+
Ein laufender BlueBubbles-Server mit aktiviertem API-Zugriff

Einrichtung

git clone https://github.com/metaember/bluebubbles-mcp.git
cd bluebubbles-mcp
uv sync

Konfiguration

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (z. B. Claude Code ~/.claude/settings.json):

{
  "mcpServers": {
    "bluebubbles": {
      "command": "uv",
      "args": ["--directory", "/path/to/bluebubbles-mcp", "run", "python", "-m", "bb_mcp.server"],
      "env": {
        "BLUEBUBBLES_URL": "https://your-bluebubbles-server",
        "BLUEBUBBLES_PASSWORD": "your-server-password"
      }
    }
  }
}

Tools

Tool	Beschreibung	Anmerkungen
`ping`	Überprüft die Serververbindung	schreibgeschützt
`get_server_info`	Serverinformationen und Status	schreibgeschützt
`list_chats`	Konversationen nach letzter Aktivität auflisten	schreibgeschützt
`get_chat`	Chat-Details mit Teilnehmern	schreibgeschützt
`get_chat_messages`	Nachrichten aus einem Chat	schreibgeschützt
`search_messages`	Suche nach Text, Chat, Zeitbereich	schreibgeschützt
`get_message`	Einzelne Nachricht nach GUID	schreibgeschützt
`get_contacts`	Alle Kontakte	schreibgeschützt
`lookup_contact`	Suche nach Telefonnummer/E-Mail	schreibgeschützt
`check_imessage`	iMessage-Registrierung prüfen	schreibgeschützt
`check_facetime`	FaceTime-Registrierung prüfen	schreibgeschützt
`list_scheduled_messages`	Zukünftige Nachrichten auflisten	schreibgeschützt
`get_recent_messages`	Nachrichten der letzten N Minuten aus allen Chats	schreibgeschützt
`get_unread_chats`	Chats mit ungelesenen Nachrichten + deren neueste Nachrichten	schreibgeschützt
`get_attachment_info`	Metadaten des Anhangs	schreibgeschützt
`download_attachment`	Anhang als base64 herunterladen	schreibgeschützt
`mark_chat_read`	Lesebestätigung senden	idempotent, open-world
`mark_chat_unread`	Chat als ungelesen markieren (lokal)	idempotent
`rename_group`	Gruppenchat umbenennen	idempotent
`start_typing`	Tipp-Indikator anzeigen	open-world
`stop_typing`	Tipp-Indikator stoppen	open-world
`send_message`	An bestehenden Chat senden	open-world
`send_message_to_address`	An Telefonnummer/E-Mail senden	open-world
`send_attachment`	Dateianhang senden	open-world
`send_reaction`	Tapback-Reaktion	open-world
`edit_message`	Gesendete Nachricht bearbeiten	open-world
`schedule_message`	Zukünftige Nachricht planen	open-world
`add_participant`	Zu Gruppenchat hinzufügen	open-world
`unsend_message`	Nachricht zurückziehen	destruktiv, open-world
`remove_participant`	Aus Gruppenchat entfernen	destruktiv, open-world
`leave_chat`	Gruppenchat verlassen	destruktiv, open-world
`delete_chat`	Konversation löschen	destruktiv, open-world
`delete_scheduled_message`	Geplante Nachricht stornieren	destruktiv, open-world