De MCP-server

Laat Claude en andere agents doorzoeken wat je hebt geëxporteerd.

Exporter draait een MCP-server in de app. Die biedt je exportmappen aan Claude, Cursor, VS Code en elke andere MCP-client aan, alleen-lezen en alleen op je Mac. Voor de skills en de opdrachtregel die een agent ook kan gebruiken, zie Voor agents.

Starten

Exporteer minstens één app als Markdown (aan de slag). De server leest alleen Markdown-bestanden.
Druk op de kaart MCP-server op “starten”. De kaart toont dan localhost:8744 en een rij “verbinden”.

Het endpoint is http://localhost:8744/mcp (Streamable HTTP), op een vaste poort. De server leeft in de app: hij antwoordt zolang Exporter draait, met het venster open of dicht, en stopt als je de app afsluit. Draaide hij toen je de app afsloot, dan start hij weer samen met de app. curl -s http://127.0.0.1:8744/health antwoordt OK zolang hij draait.

Claude Code verbinden

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

Voeg --scope user toe om hem in elk project te hebben. De knop “claude code” op de kaart kopieert deze opdracht.

Claude Desktop, Cursor en VS Code

Claude Desktop: druk op “claude desktop” op de kaart. Die kopieert een vermelding die npx -y mcp-remote http://localhost:8744/mcp uitvoert (npx hoort bij Node.js). Plak die binnen mcpServers onder Settings > Developer > Edit Config, bewaar, stop Claude en open hem opnieuw
Cursor of VS Code: druk op “cursor” of “vs code” op de kaart. De editor opent met de server klaar om te installeren; bevestig het daar

Welke mappen hij aanbiedt

De exportmappen die in dezelfde bovenliggende map staan als de exportmap van Apple Notities (zonder die map: de eerste exportmap die hij vindt). Een exportmap op een andere plek is onzichtbaar voor agents, en de kaart MCP-server zegt welke ze kunnen zien.

exportmappen	aangeboden
`~/Documents/notes`, `~/Documents/messages`	allebei
`~/Documents/notes`, `~/Dropbox/messages`	alleen notes

Om een map erbij te halen, druk je op “wijzigen…” in de rij exporteren naar van die app, kies je een map in dezelfde bovenliggende map en druk je daarna op die kaart op “volledig opnieuw synchroniseren”. De server leest zijn lijst met mappen bij het starten, dus druk na elke wijziging op “stoppen” en “starten”. Elke bron heet naar zijn map, zoals notes of messages.

De zes tools

tool	wat hij doet	parameters
`get_stats`	per bron: aantal bestanden, nieuwste en oudste datum, grootte. Roep hem als eerste aan om de namen van de bronnen te leren	`source` (optioneel)
`search`	gerangschikt zoeken in de volledige tekst	`query`, `source` (optioneel), `limit` (20)
`read`	één item: de Markdown, front matter, wijzigingsdatum en grootte	`source`, `id` (de bestandsnaam zonder `.md`)
`list`	de items van één bron	`source`, `limit` (50), `offset` (0)
`get_recent`	de items die het laatst zijn gewijzigd	`sources` (gescheiden door komma’s, optioneel), `limit` (20)
`get_metadata`	aantallen en tijden van de laatste synchronisatie	`source` (optioneel)

search rangschikt Apple Notities, Contacten en Berichten via de index van de app: een naam vindt het gesprek, en een treffer in een notitie heeft een link die hem opent in Apple Notities. Bear, Logseq, Schermtijd en Documenten worden ook aangeboden, maar search rangschikt ze niet zolang de index antwoordt; bereik ze met list, get_recent en read. Zolang de index nog leeg is, doorzoekt search de Markdown van elke bron.

Antwoorden zijn zo volledig als de export: met de gratis hoeveelheid zijn dat je eerste 100 notities, 100 contacten en 10 recentste gesprekken, 10 dagen en 10 documenten.

Privacy

De server luistert op 127.0.0.1, dus niets buiten je Mac kan erbij, en hij leest alleen. Wat een tool teruggeeft, wordt deel van je gesprek met de AI en gaat naar het model ervan, net als alles wat je plakt.

Als het niet werkt

Geen exportmappen ingesteld. Stel eerst een exportmap in.: kies een exportmap op een kaart
Geen geëxporteerde notities gevonden. Voer eerst een export uit.: druk op een kaart op “nu synchroniseren” en daarna op “starten”
een systeemfout bij “starten”: een ander programma gebruikt poort 8744. Sluit dat af en start opnieuw
er ontbreekt een bron: die staat buiten de bovenliggende map, is alleen als HTML geëxporteerd, verscheen nadat de server startte, of valt buiten de gratis hoeveelheid