Apple Notes MCP-Server

Name: Apple Notes MCP Server
Author: ailenshen

Lesen und Schreiben von Apple Notes mit Unterstützung für natives Apple Notes-Format.

apple-notes-mcp MCP-Server

Die meisten Apple Notes MCP-Server können nur reinen Text schreiben. Dieser Server erstellt nativ formatierte Notizen – Titel, Überschriften, Fettgedrucktes und Listen werden als echte Apple Notes-Stile gerendert, nicht als reiner Text. Dies wird durch die Nutzung der integrierten Markdown-Importfunktion von Notes.app erreicht.

Voraussetzungen: macOS 26 (Tahoe) oder neuer, Node.js 24+

Einrichtung

1. Zu Ihrem MCP-Client hinzufügen

Claude Desktop – bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@ailenshen/apple-notes-mcp@latest"]
    }
  }
}

Claude Code – führen Sie dies im Terminal aus:

claude mcp add apple-notes -- npx -y @ailenshen/apple-notes-mcp@latest

2. Berechtigungen erteilen

Um die native Formatierung zu unterstützen, verwendet der Server den integrierten Markdown-Import von Notes.app – er öffnet .md-Dateien mit Notes.app und bestätigt automatisch den Import-Dialog. Dies erfordert zwei macOS-Berechtigungen für node:

Berechtigung	Wo zu aktivieren	Grund
Festplattenvollzugriff	Systemeinstellungen > Datenschutz & Sicherheit > Festplattenvollzugriff > `node` aktivieren	Lesen der Notizdatenbank zum Auflisten und Suchen
Bedienungshilfen	Systemeinstellungen > Datenschutz & Sicherheit > Bedienungshilfen > `node` aktivieren	Automatisches Bestätigen des Import-Dialogs beim Erstellen von Notizen

Bei der ersten Verwendung werden Sie von macOS aufgefordert, den Zugriff zu genehmigen – klicken Sie einfach auf „Erlauben“. Falls Sie die Aufforderung verpasst haben, gehen Sie zu den oben genannten Einstellungen und aktivieren Sie node manuell. Starten Sie nach der Erteilung der Berechtigungen Ihren MCP-Client neu.

Wenn eine Berechtigung fehlt, teilt Ihnen der Server genau mit, welche es ist und wie Sie sie beheben können.

3. Verwendung

Sprechen Sie einfach ganz natürlich mit Ihrer KI:

„Liste alle meine Notizen im Ordner Projekte auf“
„Suche in meinen Notizen nach 'Meeting-Agenda'“
„Lies meine Notiz Einkaufsliste“
„Erstelle eine Notiz in Arbeit mit den heutigen Aufgaben“
„Aktualisiere meine Einkaufsliste mit diesen neuen Punkten“
„Lösche die Notiz mit dem Namen 'Alter Entwurf'“

Was kann er tun?

Tool	Beschreibung
`list_notes`	Notizen durchsuchen, optional nach Ordner filtern
`search_notes`	Notizen nach Stichwort finden
`get_note`	Vollständigen Inhalt als Markdown lesen
`create_note`	Markdown schreiben → nativ formatierte Notiz
`update_note`	Inhalt ersetzen, Ordner beibehalten
`delete_note`	In „Zuletzt gelöscht“ verschieben

Markdown-Unterstützung in Notizen

Element	Funktioniert?
Überschriften, fett, kursiv, Listen, `inline code`	Ja
Blockzitate	Inhalt bleibt erhalten, kein Einzugsstil
Links	Text bleibt erhalten, URL geht verloren
Tabellen, Fußnoten	Nein

Fernzugriff (HTTP-Modus)

Sie möchten von Ihrem Telefon oder einem anderen Computer auf Ihre Apple Notes zugreifen?

npx @ailenshen/apple-notes-mcp@latest --http

Dies gibt eine Endpunkt-URL mit einem integrierten Geheimnis aus:

Endpoint: http://localhost:3100/mcp/a3f8b2c9e1d4...

Verweisen Sie Ihren Remote-MCP-Client auf diese URL. Um über das Internet darauf zuzugreifen, platzieren Sie sie mithilfe eines Tunnels (ngrok, Cloudflare Tunnel usw.) hinter HTTPS.

Flag	Standard	Beschreibung
`--port <number>`	3100	Portnummer
`--secret <string>`	zufällig	Benutzerdefiniertes URL-Geheimnis

Damit der Server nach einem Neustart weiterläuft, finden Sie im Wiki ein Beispiel für einen LaunchAgent.

Funktionsweise

Aktion	Methode	Geschwindigkeit
Auflisten / Suchen	SQLite (schreibgeschützt)	< 100ms
Lesen	AppleScript → Markdown	~1s
Erstellen	Nativer Markdown-Import	~0.5s
Aktualisieren	Löschen + Erstellen	~1.5s
Löschen	AppleScript	~1s

Lesen: Fragt die Notizdatenbank direkt über SQLite ab – schnell und sicher. Der Inhalt wird über turndown von Apples HTML in Markdown konvertiert.
Erstellen: Verwendet den nativen Markdown-Import von macOS (open -a Notes), sodass die Formatierung nativ erhalten bleibt. Notes.app erscheint während der Erstellung kurzzeitig (~0,5s).
Aktualisieren: Löscht die alte Notiz und erstellt eine neue, wobei der ursprüngliche Ordner automatisch beibehalten wird.
Löschen: Verschiebt Notizen in „Zuletzt gelöscht“, genau wie bei der manuellen Löschung.

Bekannte Einschränkungen

Teilweises Bearbeiten von Notizen (z. B. „korrigiere nur diesen Absatz“) wird nicht unterstützt. update_note ersetzt immer den gesamten Inhalt. Dies ist eine grundlegende Einschränkung der Art und Weise, wie Notizen Inhalte bereitstellen – die AppleScript-Schnittstelle gibt HTML zurück, nicht das ursprüngliche Markdown, daher ist ein sauberer Lese-Bearbeitungs-Schreib-Zyklus derzeit nicht möglich.
Notizen erscheinen kurzzeitig während der Erstellung. Der Markdown-Import-Ablauf erfordert das automatische Bestätigen eines Dialogs in Notes.app, was die App kurzzeitig in den Vordergrund bringen kann.

Diese Einschränkungen würden aufgehoben, wenn Apple Markdown-Import/-Export zu AppleScript hinzufügen oder eine offizielle Notes-API veröffentlichen würde – beides wird für zukünftige macOS-Versionen verfolgt.

Vision

Apple Notes ist der natürlichste Ort, um persönliches Wissen auf Apple-Geräten zu speichern – es synchronisiert überall, ist schnell und privat. Aber es ist ein geschlossenes System ohne API.

Dieses Projekt macht Apple Notes zu einer erstklassigen Datenquelle für KI. Das langfristige Ziel: Wo auch immer Sie mit einer KI sprechen – auf Ihrem Mac, Ihrem Telefon oder im Web – Ihre Apple Notes sind immer zugänglich, lesbar und beschreibbar.

Lizenz

MIT

Apple Notes MCP Server