Le serveur MCP

Exporter fait tourner un serveur MCP dans l’app. Il sert vos dossiers d’export à Claude, Cursor, VS Code et à tout autre client MCP, en lecture seule et sur votre Mac uniquement. Pour les skills et la ligne de commande qu’un agent peut aussi utiliser, consultez Pour les agents.

Le démarrer

1. Exportez au moins une app en Markdown (premiers pas). Le serveur ne lit que les fichiers Markdown.
2. Sur la carte Serveur MCP, appuyez sur « démarrer ». La carte affiche alors localhost:8744 et une ligne « connecter ».

Le point d’accès est http://localhost:8744/mcp (Streamable HTTP), sur un port fixe. Le serveur vit dans l’app : il répond tant qu’Exporter tourne, fenêtre ouverte ou fermée, et s’arrête quand vous quittez l’app. S’il tournait quand vous avez quitté, il redémarre avec l’app. curl -s http://127.0.0.1:8744/health répond OK tant qu’il est actif.

Connecter Claude Code

claude mcp add --transport http exporter http://localhost:8744/mcp

Ajoutez --scope user pour l’avoir dans tous vos projets. Le bouton « claude code » de la carte copie cette commande.

Claude Desktop, Cursor et VS Code

• Claude Desktop : appuyez sur « claude desktop » sur la carte. Il copie une entrée qui lance npx -y mcp-remote http://localhost:8744/mcp (npx est fourni avec Node.js). Collez-la dans mcpServers sous Settings > Developer > Edit Config, enregistrez, puis quittez Claude et rouvrez-le
• Cursor ou VS Code : appuyez sur « cursor » ou « vs code » sur la carte. L’éditeur s’ouvre avec le serveur prêt à être installé ; confirmez-y

Les dossiers servis

Les dossiers d’export qui se trouvent dans le même dossier parent que le dossier d’export d’Apple Notes (sans lui, le premier dossier d’export trouvé). Un dossier d’export situé ailleurs est invisible pour les agents, et la carte Serveur MCP indique ceux qu’ils peuvent voir.

dossiers d’export	servis
~/Documents/notes, ~/Documents/messages	les deux
~/Documents/notes, ~/Dropbox/messages	notes uniquement

Pour intégrer un dossier, appuyez sur « changer… » sur la ligne exporter vers de cette app, choisissez un dossier dans le même parent, puis « resynchronisation complète » sur cette carte. Le serveur lit sa liste de dossiers au démarrage : appuyez donc sur « arrêter » puis « démarrer » après tout changement. Chaque source porte le nom de son dossier, comme notes ou messages.

Les six outils

outil	effet	paramètres
get_stats	par source : nombre de fichiers, dates la plus récente et la plus ancienne, taille. Appelez-le en premier pour connaître les noms des sources	source (facultatif)
search	recherche plein texte classée	query, source (facultatif), limit (20)
read	un élément : son Markdown, son front matter, sa date de modification et sa taille	source, id (le nom du fichier sans .md)
list	les éléments d’une source	source, limit (50), offset (0)
get_recent	les éléments modifiés le plus récemment	sources (séparées par des virgules, facultatif), limit (20)
get_metadata	nombres et heures de dernière synchronisation	source (facultatif)

search classe Apple Notes, Contacts et Messages à l’aide de l’index de l’app : un nom trouve la conversation, et un résultat de note porte un lien qui l’ouvre dans Apple Notes. Bear, Logseq, Temps d’écran et Documents sont servis aussi, mais search ne les classe pas tant que l’index répond ; atteignez-les avec list, get_recent et read. Tant que l’index est encore vide, search parcourt le Markdown de chaque source.

Les réponses ne sont pas plus complètes que l’export : avec le quota gratuit, ce sont vos 100 premières notes, 100 contacts et 10 conversations les plus récentes, 10 jours et 10 documents.

Confidentialité

Le serveur écoute sur 127.0.0.1 : rien en dehors de votre Mac ne peut l’atteindre, et il ne fait que lire. Ce que renvoie un outil fait partie de votre conversation avec l’IA et part vers son modèle, comme tout ce que vous collez.

Quand ça ne marche pas

• Aucun dossier d’export configuré. Définissez-en un d’abord. : choisissez un dossier d’export sur n’importe quelle carte
• Aucune note exportée. Lancez d’abord un export. : appuyez sur « synchroniser » sur une carte, puis sur « démarrer »
• une erreur système au « démarrer » : un autre programme utilise le port 8744. Quittez-le et démarrez à nouveau
• une source manque : elle se trouve hors du dossier parent, a été exportée uniquement en HTML, est apparue après le démarrage du serveur, ou dépasse le quota gratuit