Synchroniser Apple Notes, indexer avec LEANN et interroger via Claude Code

Apple Notes est un excellent outil de prise de notes. Mais vos données restent enfermées dans l’écosystème Apple, sans recherche sémantique, sans accès depuis vos outils de développement.

J’ai mis en place un workflow qui exporte mes notes en Markdown, les indexe dans une base vectorielle locale et me permet de les interroger depuis Claude Code. Quatre briques, tout automatisé.

Exporter Apple Notes en Markdown

PYAppleNoteExporter est un script Python que j’ai développé pour extraire toutes mes notes Apple en Markdown. Zéro dépendance externe, juste Python 3.10+ et macOS.

Le script convertit le HTML d’Apple Notes en Markdown propre : titres, listes, cases à cocher, images en base64 extraites en fichiers séparés. Les notes protégées par mot de passe sont ignorées proprement.

git clone https://github.com/isebmo/PYAppleNoteExporter.git ~/bin/PYAppleNoteExporter

Pour lancer un export complet :

python3 ~/bin/PYAppleNoteExporter/export_notes.py --output ~/Documents/AppleNotes

Le flag --incremental ne retraite que les notes modifiées depuis le dernier passage. Pratique pour les exports quotidiens. Vous pouvez aussi cibler un dossier précis avec --folder "MonDossier".

python3 ~/bin/PYAppleNoteExporter/export_notes.py --output ~/Documents/AppleNotes --incremental

Chaque fichier Markdown généré contient un frontmatter YAML avec le titre, les dates de création et modification, le compte et le dossier d’origine. La hiérarchie de dossiers Apple Notes est préservée dans l’arborescence de sortie.

Indexer ses notes avec LEANN

LEANN est une base vectorielle locale dont j’ai parlé récemment. Elle transforme vos fichiers Markdown en index sémantique interrogeable, avec un stockage 97% plus compact que les solutions classiques.

Installation :

curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/yichuan-w/LEANN.git && cd LEANN
uv venv && source .venv/bin/activate
uv pip install leann

Sur macOS, ajoutez les dépendances natives :

brew install libomp boost protobuf zeromq pkgconf
uv sync --extra diskann

Pour indexer vos notes exportées :

leann build apple-notes --docs ~/Documents/AppleNotes/**/*.md

Un test rapide :

python -m apps.document_rag --query "recette tarte aux pommes"

La recherche est sémantique. Elle comprend le sens de votre requête, pas juste les mots-clés. Sans le flag --query, vous entrez en mode interactif pour enchaîner les questions.

Un skill Claude Code pour tout automatiser

Les skills Claude Code sont des fichiers SKILL.md avec des instructions que Claude exécute à la demande.

Créez le dossier du skill :

mkdir -p ~/.claude/skills/sync-notes

Dans ~/.claude/skills/sync-notes/SKILL.md, placez le frontmatter YAML :

---
name: sync-notes
description: Synchronise Apple Notes en Markdown et réindexe avec LEANN.
user-invocable: true
allowed-tools:
  - Bash
---

Puis les instructions en Markdown : lancer export_notes.py --incremental pour l’export, puis leann build apple-notes pour réindexer. Un /sync-notes dans Claude Code et les deux étapes s’enchaînent.

Vous pouvez personnaliser le skill selon vos besoins. Retirer le --incremental pour forcer l’export complet, ou ajouter --force-rebuild côté LEANN pour reconstruire l’index de zéro.

Connecter LEANN à Claude Code via MCP

LEANN expose un serveur MCP. Deux commandes suffisent pour l’enregistrer :

uv tool install leann-core --with leann
claude mcp add --scope user leann-server -- leann_mcp

Le flag --scope user rend le serveur disponible dans tous vos projets. Vérification :

claude mcp list | cat

Deux outils deviennent disponibles dans Claude Code :

leann_search - recherche sémantique dans vos index
leann_list - liste les index disponibles

Vous pouvez demander à Claude : “Cherche dans mes notes tout ce qui concerne le projet X” et il interrogera votre index local. Les résultats sont classés par pertinence sémantique.

Si vous utilisez déjà Claude Code pour développer vos workflows, ajouter vos notes personnelles comme source de contexte ouvre des possibilités concrètes : retrouver une idée notée il y a six mois, croiser des notes de réunion avec du code, alimenter un prompt avec du contexte personnel.

Le workflow tient en quatre briques : PYAppleNoteExporter pour l’extraction, LEANN pour l’indexation, un skill pour l’automatisation, MCP pour la connexion. Chaque brique fonctionne indépendamment et le même principe s’applique à n’importe quelle source de données locale - fichiers Obsidian, bookmarks, journaux 📄