So verbindest du HappyCapy mit iMessage: Ein vollwertiger KI-Agent in Apple Nachrichten
BlueBubbles + HappyCapys capy-bridge: derselbe Stack, den Hermes Agent nutzt — jetzt als One-Click-Skill verfügbar.
Apple hat nie eine iMessage-API veröffentlicht. Nicht 2015. Nicht 2020. Auch heute nicht. Jahrelang erforderte der Bau eines KI-Agenten, der in deinen iMessages lebt, entweder einen Jailbreak, einen Enterprise-Plan für 200 $/Monat oder ein tiefes Verständnis undokumentierter Protokolle. Im Juni 2026 funktioniert endlich ein kostenloser, quelloffener Weg zuverlässig — und es ist dieselbe Architektur, die das 188.000-Sterne-Projekt Hermes Agent produktiv einsetzt.
Warum iMessage die schwierigste Plattform ist (und warum das wichtig ist)
Die meisten Messaging-Plattformen haben eine API. Telegram veröffentlichte ihre 2015. Slack hat seit dem ersten Tag Webhooks. WhatsApp öffnete 2018 seine Business-API. iMessage hatte nichts davon, und das ist kein Versehen.
Apples iMessage-Protokoll verwendet Ende-zu-Ende-Verschlüsselung, die direkt an Apple-IDs und gerätespezifische Schlüssel gebunden ist. Diese Schlüssel werden auf Apple-Hardware generiert und verlassen sie nie. Jede Nachricht wird auf einem physischen Apple-Gerät ver- und entschlüsselt. Es gibt keine serverseitige API, weil es keinen Server gibt, der den entschlüsselten Inhalt hält. Das ist eine harte kryptografische Einschränkung — keine Richtlinienentscheidung, die Apple mit einer Pressemitteilung rückgängig machen könnte.
Die praktische Konsequenz: Kein Linux-Prozess, kein Docker-Container, keine Cloud-VM kann nativ iMessages senden oder empfangen. Nicht einmal mit Root-Zugriff. Nicht einmal mit einer gültigen Apple-ID. Das Protokoll funktioniert schlicht nicht außerhalb von Apple-Hardware.
Für Entwickler von KI-Agenten bedeutet das: iMessage-Integration erfordert immer einen Mac in der Kette. Das ist die ehrliche Antwort, und sie prägt alles Weitere in diesem Artikel.
Die Kehrseite gilt ebenso: Für Apple-Nutzer bedeutet diese Architektur, dass der Bot innerhalb von Messages.app selbst lebt. Keine Drittanbieter-App zum Installieren. Kein neues Konto zum Anlegen. Die KI antwortet über dieselbe Oberfläche, die deine Familie und Kollegen bereits nutzen. Wenn deine Kontakte dir schreiben, bemerken sie nicht, dass sich etwas geändert hat — sie sehen Antworten von deiner Apple-ID, formatiert als native iMessages, mit Lesebestätigungen.
Diese Kombination — null Reibung für den Empfänger, kryptografisch privat, auf der Plattform, der Apple-Nutzer bereits vertrauen — ist der Grund, warum iMessage den zusätzlichen Aufwand wert ist.
Wie es tatsächlich funktioniert
Die kostenlose, quelloffene Lösung heißt BlueBubbles. Es ist eine MIT-lizenzierte Mac-Server-Anwendung, die auf deinem Mac läuft, sich bei deiner Apple-ID registriert und eine lokale REST-API bereitstellt. BlueBubbles fungiert als Brücke zwischen dem iMessage-Protokoll (das macOS erfordert) und jedem externen Dienst, der HTTP-Anfragen stellen kann.
HappyCapys capy-bridge verbindet sich mit dieser REST-API. Wenn eine Nachricht bei deiner Apple-ID eintrifft, läuft folgende Sequenz ab:
| Schritt | Was passiert |
|---|---|
| 1. iMessage empfangen | Apple stellt die Nachricht über das Standard-iMessage-Protokoll an deinen Mac zu |
| 2. BlueBubbles fängt ab | Der BlueBubbles-Server auf deinem Mac liest die eingehende Nachricht |
| 3. Webhook POST | BlueBubbles sendet die Nachrichtennutzlast per POST an den capy-bridge-Endpunkt von HappyCapy |
| 4. Bridge verarbeitet | capy-bridge analysiert Absender, Nachrichtentext und Konversationsverlauf |
5. claude --print | Die Bridge startet die Claude Code CLI mit vollem Werkzeugzugriff |
| 6. Claude führt aus | Claude nutzt Werkzeuge — bash, Websuche, Dateioperationen, jedes installierte Skill |
| 7. Antwort gesendet | Die Antwort wird über die REST-API von BlueBubbles zurück an den ursprünglichen iMessage-Thread gesendet |
| 8. iMessage zugestellt | Der Empfänger sieht innerhalb weniger Sekunden eine Antwort in seiner Messages.app |
Dies ist dieselbe Architektur, die Hermes Agent verwendet. Das Hermes-Agent-Projekt — 188.000 GitHub-Sterne, entwickelt von Nous Research — leitet seine iMessage-Integration in seiner Produktionskonfiguration über BlueBubbles. Die Architektur wurde im großen Maßstab belastungsgetestet.
Das entscheidende Detail in Schritt 5 ist claude --print. HappyCapy schickt deine Nachricht nicht an einen Chatbot, der mit Text antwortet. Es führt die Claude Code CLI aus, die vollen Werkzeugzugriff hat: Bash-Ausführung, Datei-Lese-/Schreibzugriff, Websuche, Bildgenerierung und Zugriff auf HappyCapys Bibliothek mit über 300.000 Skills. Der Bot antwortet nicht nur — er handelt.
Was du tun kannst
Sobald die Bridge läuft, wird jede iMessage an deine Apple-ID zu einer Befehlsschnittstelle für deine HappyCapy-Sandbox:
- Aufgaben remote ausführen — sende eine Aufgabe von deinem iPhone, erhalte ein vollständig ausgeführtes Ergebnis mit Ausgabe zurück
- Dateien anfordern — bitte um einen PDF-Bericht, ein generiertes Bild oder ein Skript und erhalte es
- Suchen und zusammenfassen — bitte den Agenten, das Web zu durchsuchen und eine strukturierte Zusammenfassung zurückzugeben
- Über 300.000 Skills auslösen — jedes Skill in HappyCapys Bibliothek ist von Messages.app aus zugänglich
- Bash auf deiner Sandbox ausführen —
run ls /var/logwird auf deiner HappyCapy-Linux-Umgebung ausgeführt und gibt die Ausgabe zurück - Verlauf pro Kontakt — jede Apple-ID oder Telefonnummer erhält einen eigenen Konversations-Thread; der Kontext bleibt über Nachrichten hinweg erhalten
- Funktioniert von jedem Apple-Gerät aus — iPhone, iPad, Mac, Apple Watch — alles, was iMessages sendet, erreicht den Bot
Vorteile
- Native Apple-Erfahrung — Antworten erscheinen im Standard-Messages.app-Thread; Empfänger müssen nichts installieren
- Keine Drittanbieter-App auf dem Gerät des Empfängers — der Bot kommuniziert über die bestehende iMessage-Infrastruktur
- Funktioniert mit jeder Apple-ID — jeder Kontakt, der dir iMessages schreiben kann, kann mit dem Bot interagieren
- Ende-zu-Ende-Verschlüsselung — BlueBubbles bricht Apples Verschlüsselung nicht; es liest Nachrichten, nachdem sie auf deinem Mac entschlüsselt wurden
- Kostenlos und quelloffen — BlueBubbles ist MIT-lizenziert; es gibt keine Abonnementgebühren
- Von Hermes validierte Architektur — derselbe Stack, der ein 188.000-Sterne-Produktionsagentenprojekt antreibt
- Volle Agentenfähigkeit —
claude --printgibt dem Bot Bash-Zugriff, Websuche, Dateioperationen und über 300.000 Skills
Reale Anwendungsfälle
Entwickler unterwegs mit dem iPhone. Du bist nicht an deinem Laptop und musst prüfen, ob ein Cron-Job gelaufen ist, eine Logdatei verfolgen oder einen Dienst auf deiner HappyCapy-Sandbox neu starten. Du sendest den Befehl von Messages.app auf deinem iPhone. Die Bridge führt ihn aus und gibt die Ausgabe als Antwort zurück. Kein SSH-Client, kein VPN, kein Kontextwechsel.
Apple-only-Haushalt. Dein Partner, deine Eltern oder Mitbewohner nutzen ausschließlich iMessages und sonst nichts. Statt sie zu bitten, Telegram zu installieren oder eine neue Oberfläche zu lernen, richtest du den Bot auf deine bestehende Apple-ID aus. Alle interagieren über die App, die bereits auf ihrem Gerät ist.
Geschäftsinhaber mit iMessage-Kunden. Du kommunizierst mit Kunden über iMessage — es ist das, was sie nutzen, und sie auf eine andere Plattform umzustellen ist unrealistisch. Mit laufender Bridge kannst du den Agenten bitten, einen langen Thread zusammenzufassen, eine Antwort in deinem Stil zu entwerfen, die Bestellhistorie eines Kunden nachzuschlagen oder einen Bericht abzurufen. Die KI bleibt in dem Kanal, in dem die Beziehung bereits stattfindet.
Forscher mit einem Mac. Du hast einen Mac, der auf deinem Schreibtisch läuft. Du möchtest einen KI-Agenten, der immer erreichbar ist — von deinem iPhone während des Pendelns, von deinem iPad in einem Meeting, vom Mac eines Kollegen im Notfall. iMessage ist bereits über jedes Apple-Gerät synchronisiert, das du besitzt. Der Bot erbt diese Reichweite automatisch.
Die Mac-Voraussetzung — ehrliche Einschätzung
Die Einrichtung erfordert einen Mac mit installiertem und laufendem BlueBubbles, verbunden mit HappyCapy über capy-bridge. Der Mac muss wach und online sein, damit die Bridge funktioniert. Geht er in den Ruhezustand, geht der Bot offline.
Das ist eine echte Einschränkung. Wenn du keinen Mac besitzt oder dein Mac ein Laptop ist, den du herumträgst und regelmäßig zuklappst, ist iMessage der falsche Kanal für dich. HappyCapys Telegram- und Slack-Integrationen laufen auf vollständig Linux-nativer Infrastruktur ohne Hardware-Abhängigkeit.
Für Leute, die bereits einen Mac betreiben, der eingeschaltet bleibt — einen Mac Mini unter dem Fernseher, einen Mac Studio im Homeoffice, ein älteres MacBook, das auf einem Regal angeschlossen ist — ist die Einrichtung einmalig und danach vollständig automatisch. BlueBubbles startet beim Login. Der capy-bridge-Daemon startet beim Login. Der Mac läuft weiter, und damit auch der Bot.
Wenn du dedizierte Hardware für diesen Zweck in Betracht ziehst, ist das 2026er Mac Mini M4 Basismodell (799 $) die praktischste Option. Es verbraucht im Leerlauf etwa 6–10 Watt, unterstützt 24/7-Betrieb ohne Lüftergeräusche und passt in einen Raum, der kleiner ist als ein Taschenbuch. Eine vollständige Aufschlüsselung von Mac-Mini-KI-Server-Setups findest du unter Mac Mini as an AI Server in 2026.
Wie man es einrichtet
Die vollständige Einrichtung dauert etwa 10 Minuten:
- BlueBubbles herunterladen unter bluebubbles.app — kostenlos, MIT-lizenziert, quelloffen
- Den Einrichtungsassistenten ausführen — mit deiner Apple-ID anmelden und Bedienungshilfen- + Vollzugriff-auf-die-Festplatte-Berechtigungen erteilen
- Deine BlueBubbles-URL und dein Passwort notieren aus dem BlueBubbles-Einstellungsbildschirm
- capy-bridge installieren — führe
bash /app/export-port.sh 8766in HappyCapy aus, um deine Webhook-URL zu erhalten, und führe dann das Skill/happycapy-imessagein HappyCapy aus - Den HappyCapy-Assistenten abschließen — füge deine BlueBubbles-URL, dein Passwort und die Webhook-URL ein; die Bridge registriert sich automatisch
- Testen — sende eine iMessage von einem anderen Gerät; du solltest innerhalb von Sekunden eine Antwort erhalten
Die vollständige Skill-Dokumentation und der Quellcode befinden sich unter github.com/ndpvt-web/happycapy-imessage.
Häufig gestellte Fragen
Muss ich meinen Mac die ganze Zeit eingeschaltet lassen? Ja, für 24/7-Verfügbarkeit. Der Mac muss wach und online sein, damit BlueBubbles und die capy-bridge eingehende Nachrichten empfangen können. Wenn du den Bot rund um die Uhr verfügbar haben möchtest, verwende Hardware, die eingeschaltet bleiben kann — ein Mac Mini oder Mac Studio ist ideal. Aktiviere „Display-Ruhezustand verhindern" in den BlueBubbles-Einstellungen und deaktiviere den Ruhezustand in den macOS-Energiesparoptionen (Netzteil-Modus).
Funktioniert das auch mit SMS, oder nur mit iMessage? BlueBubbles unterstützt sowohl iMessage (blaue Blasen) als auch SMS (grüne Blasen), wenn dein Mac mit einem iPhone verbunden ist und der persönliche Hotspot so konfiguriert ist, dass die SMS-Weiterleitung aktiviert ist. Für die meisten Setups ist reines iMessage einfacher und zuverlässiger.
Kann Apple meine Nachrichten über BlueBubbles sehen? Nein. BlueBubbles bricht Apples Ende-zu-Ende-Verschlüsselung nicht. Nachrichten werden von macOS auf deinem lokalen Rechner entschlüsselt, wie immer, und BlueBubbles liest sie dann aus diesem lokalen entschlüsselten Zustand. Apples Server sehen niemals Klartextinhalte — genau wie bei normaler Nutzung von Messages.app.
Ist BlueBubbles kostenlos? Ja. BlueBubbles ist MIT-lizenziert und kostenlos nutzbar. Es gibt keine Abonnementgebühren. Die Mac-Server-App, der Quellcode und die Dokumentation sind alle öffentlich verfügbar unter bluebubbles.app.
Was passiert, wenn mein Mac in den Ruhezustand geht?
Die Bridge geht offline. Nachrichten, die gesendet werden, während der Mac schläft, werden nicht verarbeitet und nicht rückwirkend beantwortet, wenn der Mac aufwacht. Um das zu verhindern: Aktiviere „Display-Ruhezustand verhindern" in BlueBubbles, deaktiviere den Systemruhezustand in den macOS-Energiesparoptionen für Netzteilbetrieb, oder führe caffeinate -di & in einem Terminal aus. Für Always-on-Setups sind Desktop-Macs (Mini, Studio, Pro) Laptops vorzuziehen.
Können mehrere Personen den Bot von verschiedenen Apple-IDs aus anschreiben? Ja. Die Bridge speichert einen separaten Konversationsverlauf pro Absender-Handle. Jede Apple-ID oder Telefonnummer erhält ein eigenes Kontextfenster. Du kannst eine Allowlist (nur bestimmte Handles) konfigurieren oder es für alle eingehenden iMessages offen lassen.
Verstößt das gegen Apples Nutzungsbedingungen? BlueBubbles bewegt sich in einer Grauzone: Apple hat Drittanbieter-iMessage-Bridges nicht ausdrücklich genehmigt, ist aber in den über vier Jahren, in denen BlueBubbles in Betrieb ist, auch nicht dagegen vorgegangen. Das Projekt liest Nachrichten von deinem eigenen Mac, unter deiner eigenen Apple-ID, auf dieselbe Weise, wie es jeder Prozess mit Vollzugriff auf die Festplatte könnte. Es für deine eigene Automatisierung zu nutzen — nicht für kommerzielles Massenversenden oder Spam — entspricht der Art, wie zehntausende Entwickler es nutzen. Das Hermes-Agent-Projekt liefert die BlueBubbles-Integration ab 2026 standardmäßig in seiner Konfiguration mit.
Abschließende Gedanken
Von den vier Messaging-Kanälen, die HappyCapy unterstützt — Telegram, Slack, WhatsApp und iMessage — ist iMessage der technisch anspruchsvollste in der Einrichtung. Es erfordert einen Mac, einen laufenden BlueBubbles-Server und eine dauerhafte Verbindung zwischen deiner Hardware und deiner HappyCapy-Sandbox. Das sind mehr bewegliche Teile als bei den anderen.
Für Apple-Nutzer, die bereits in diesem Ökosystem leben, ist es zugleich das nahtloseste Ergebnis: ein vollwertiger KI-Agent, der über die Messages-App antwortet, die deine Kontakte täglich nutzen, ohne neue Apps zu installieren und ohne neue Konten anzulegen. Die Architektur ist bewährt — derselbe Stack hinter 188.000 Sternen bei Hermes Agent — und HappyCapy verpackt sie in ein Ein-Klick-Skill.
Wenn du einen Mac hast, der eingeschaltet bleibt, sind die 10 Minuten Einrichtung es wert.
