MCP Apple Notizen

Ein Model Context Protocol (MCP)-Server, der semantische Suche und RAG (Retrieval Augmented Generation) für Ihre Apple Notizen ermöglicht. Funktioniert mit jedem MCP-kompatiblen Client — Claude Desktop, Cursor, Windsurf, Cline und anderen.

Funktionen

• 🔍 Semantische Suche in Apple Notizen mittels all-MiniLM-L6-v2 On-Device-Embeddings-Modell

• 📝 Volltext-Suchfunktionen

• 📂 Ordnerunterstützung — Ordner auflisten, nach Ordner durchsuchen, Suche nach Ordner filtern

• 📊 Vektorspeicherung mittels LanceDB

• 🤖 Funktioniert mit jedem MCP-kompatiblen Client (Claude, Cursor, Windsurf, Cline, etc.)

• 🍎 Native Apple Notizen-Integration via JXA

• 🔒 Optionaler Schreibgeschützter Modus für sicheres Erkunden

• 🏃♂️ Vollständig lokale Ausführung — keine API-Schlüssel erforderlich

Related MCP server: MCP Apple Notes

Sicherheit & Transparenz

Da dieser Server mit Ihren privaten Apple Notizen interagiert, wurde er mit dem Ziel absoluter Transparenz entwickelt. Er läuft zu 100 % lokal auf Ihrem Mac.

• Keine Cloud, keine Telemetrie — Keine API-Schlüssel, keine Daten verlassen Ihren Rechner.

• Native Apple JXA — Nutzt Apples offizielle JavaScript for Automation-Skriptschnittstelle.

• Embeddings auf dem Gerät — Das all-MiniLM-L6-v2-Modell läuft lokal via @huggingface/transformers.

• Überprüfbar — Sie werden ausdrücklich dazu ermutigt, jede Zeile des Codes (insbesondere index.ts) zu lesen, bevor er jemals auf Ihre Notizen zugreift.

• GitHub-Releases enthalten SHA-256-Prüfsummen, damit Sie die heruntergeladenen Artefakte verifizieren können.

Installation & Einrichtung

Wählen Sie die Installationsmethode, die zu Ihrem Workflow passt.

Methode 1: Installation aus dem Quellcode (empfohlen)

Durch das lokale Klonen des Repositorys können Sie den Quellcode prüfen und genau wissen, was auf Ihrem Rechner ausgeführt wird.

Voraussetzungen: Node.js (v18+) oder Bun

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && bun install

{
  "mcpServers": {
    "apple-notes": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-apple-notes/index.ts"]
    }
  }
}

NPM verwenden:

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && npm install

Fügen Sie dann den Server zur Konfiguration Ihres MCP-Clients hinzu. Ersetzen Sie /path/to/mcp-apple-notes durch den Pfad, unter dem Sie das Repo geklont haben:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-apple-notes/index.ts"]
    }
  }
}

Tipp: Möchten Sie es risikofrei ausprobieren? Aktivieren Sie den schreibgeschützten Modus, um alle Schreibvorgänge zu blockieren, während Sie das Tool erkunden.
"env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }

Methode 2: Schnelleinstieg via npx

Wenn Sie einen Zero-Setup-Ansatz bevorzugen und dem veröffentlichten npm-Paket vertrauen, können Sie dies einfach direkt zu Ihrer MCP-Konfiguration hinzufügen:

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

Starten Sie nach der Einrichtung Ihren Client neu und bitten Sie Ihren KI-Assistenten, "index my notes" (meine Notizen zu indizieren), um zu beginnen.

Client-spezifische Anweisungen

1. Öffnen Sie Settings → Developer → Edit Config

2. Fügen Sie Ihre gewählte JSON-Konfiguration in claude_desktop_config.json ein

3. Starten Sie Claude Desktop neu

Protokolle:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-apple-notes.log

# npm version:
claude mcp add apple-notes npx -- -y @dan8oren/mcp-apple-notes
# or from source:
claude mcp add apple-notes npx -- tsx /path/to/mcp-apple-notes/index.ts

Fügen Sie die JSON-Konfiguration zu ~/.cursor/mcp.json (global) oder .cursor/mcp.json in Ihrem Projektstammverzeichnis hinzu.

Fügen Sie die JSON-Konfiguration zu ~/.windsurf/mcp.json hinzu.

Verfügbare Tools

Überprüfung vor dem Vertrauen

Jede Apple Notizen-Operation ist ein JXA-Aufruf, den Sie in index.ts einsehen können. Keine Netzwerkanfragen, keine Hintergrundsynchronisierung — nur lokale Skriptschnittstellen-Aufrufe.

Schreibgeschützter Modus

Benötigen Sie ein Sicherheitsnetz? Aktivieren Sie den schreibgeschützten Modus, um alle Schreibvorgänge zu blockieren — nur Such-, Listen- und Lesetools sind dann verfügbar:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"],
      "env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }
    }
  }
}

Wenn aktiviert, sind nur diese Tools verfügbar: index-notes, list-folders, list-notes, search-notes, get-note.

Ausführlicher Modus (Verbose)

Aktivieren Sie die ausführliche Protokollierung, um jeden JXA-Aufruf zu sehen, bevor er ausgeführt wird (wird nach stderr protokolliert):

CLI-Flag — fügen Sie --verbose zu Ihren MCP-Client-Konfigurationsargumenten hinzu:

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

Umgebungsvariable — für Clients, die env unterstützen:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"],
      "env": { "MCP_APPLE_NOTES_VERBOSE": "1" }
    }
  }
}

Referenz der JXA-Operationen

Alle Operationen laufen über Apples JXA-Skriptschnittstelle (Application('Notes')). Kein direkter Dateisystemzugriff, keine Netzwerkaufrufe. Die delete-Operation ist nicht permanent — Notizen landen in "Zuletzt gelöscht" und können innerhalb von 30 Tagen wiederhergestellt werden.

Antwortformat

Tool-Antworten sind JSON-Objekte in einem konsistenten Umschlag:

• Erfolg: { "ok": true, "data": ... }

• Fehler: { "ok": false, "error": { "type": "...", "message": "..." } }

Die meisten notizorientierten Antworten enthalten jetzt die stabile Apple Notizen-id, sodass Clients Notizen sicher über Umbenennungen und Verschiebungen hinweg verfolgen können.

Danksagungen

Ursprünglich basierend auf RafalWilinski/mcp-apple-notes.