Alle Projekte

MCP & Tool

Apple Notes Konnektor (MCP)

In einem Satz

Du fragst nach deinen Notizen, und Claude findet sie, fasst sie zusammen oder schreibt etwas dazu.

Nutzen:

Du musst nicht mehr selbst suchen. Claude findet deine Notizen und kann Neues dazuschreiben, aber nie etwas löschen.

Wofür ist das gut?

  • Notizen finden, indem du einfach fragst, statt selbst zu suchen.
  • Viele Notizen zu einem Thema in ein paar Sätzen zusammenfassen lassen.
  • Neue Notizen oder Listen mit einem Satz anlegen.
  • Etwas zu einer bestehenden Notiz dazuschreiben lassen.

So sieht das im Alltag aus

So könnte das aussehen
  1. Du

    Such in meinen Notizen alles über den Urlaub und fass es mir zusammen.

  2. Claude

    Ich habe drei passende Notizen gefunden. Kurz gesagt, die Unterkunft ist gebucht, die Packliste ist fast fertig und für die Fähre fehlt noch das Ticket.

  3. Du

    Schreib „Fährticket kaufen“ auf meine Packliste.

  4. Claude

    Erledigt. Es steht jetzt ganz unten auf deiner Packliste.

Was bewusst nicht geht

  • Notizen löschen, verschieben oder überschreiben.
  • Notizen mit Passwort öffnen. Die bleiben immer zu.

Deine Notizen gehören dir. Claude hilft beim Finden und Aufschreiben, räumt aber nichts ohne dich um.

Für die Nerds

Entwickelt für Claude, funktioniert aber mit jedem KI-Programm, das lokale MCP-Server unterstützt (z. B. Cursor, VS Code, Gemini CLI).

  • MCP-Server in Python mit FastMCP, nutzbar in Claude Desktop und Claude Code.
  • Steuerung der Notizen-App über AppleScript bzw. JavaScript for Automation (JXA).
  • Werkzeuge: Ordner und Notizen auflisten, suchen, eine Notiz lesen, neue Notiz anlegen, Text anhängen. Löschen, Verschieben und Überschreiben gibt es absichtlich nicht.
  • Schutz vor Script-Injection: Eingaben werden als JSON übergeben und nie direkt in ein Skript eingesetzt.
  • Passwortgeschützte Notizen werden erkannt und nie gelesen.
  • Umwandlung zwischen HTML und Markdown, damit Claude die Notizen gut lesen und schreiben kann.
  • Tests mit pytest.
  • Python
  • MCP
  • FastMCP
  • AppleScript / JXA
  • pytest
HerunterladenZIP · für Mac

Hier siehst du den Quellcode. (öffnet in neuem Tab)

Einrichtung

Du brauchst: einen Mac und Claude Desktop.

  1. Schritt 1: ZIP entpacken

    Mach einen Doppelklick auf die Datei und leg den Ordner apple-notes-MCP-main an einen festen Ort, zum Beispiel in „Dokumente“.

  2. Schritt 2: Hilfsprogramm installieren

    Öffne das Terminal und füge diesen Befehl ein.

    brew install uv

  3. Schritt 3: Zubehör laden und Zugriff erlauben

    Wechsle in den Ordner, lade das Zubehör und klick bei der Frage „Terminal“ möchte „Notizen“ steuern auf OK.

    cd "/Users/DEIN-NAME/Pfad/zu/apple-notes-MCP-main"
uv sync
uv run python -c "import anyio, json; from notes_mcp import server; print(json.dumps(anyio.run(server.list_folders), ensure_ascii=False, indent=1))"

    Rot markierte Stellen musst du anpassen.

  4. Schritt 4: Claude Bescheid geben

    Öffne in Claude Desktop über Einstellungen → Entwickler → Konfiguration bearbeiten die Konfigurationsdatei und füge diesen Eintrag ein, mit deinem Ordner und dem Pfad, den which uv im Terminal zeigt.

    {
  "mcpServers": {
    "apple-notes": {
      "command": "/opt/homebrew/bin/uv",
      "args": [
        "run",
        "--directory",
        "/Users/DEIN-NAME/Pfad/zu/apple-notes-MCP-main",
        "notes-mcp"
      ]
    }
  }
}

    Rot markierte Stellen musst du anpassen.

  5. Schritt 5: Claude neu starten

    Beende Claude Desktop komplett mit ⌘Q und öffne es wieder.

  6. Schritt 6: Ausprobieren

    Frag Claude „Welche Ordner habe ich in Apple Notizen?“ und klick bei der Frage „Claude“ möchte „Notizen“ steuern wieder auf OK.

Funktioniert nicht? Schreib mir oder frag die KI.