How kzaremski/apple-notes-exporter works
Apple Notes Exporter reads notes and their hierarchy from the macOS Notes store, lets users select and filter them, converts note content and attachments into many export formats, then delivers them as a folder tree, archive, or joined file. The same export engine is exposed through the GUI, CLI, Shortcuts, and an MCP server; incremental runs track changes and prune removed notes. The graph preserves documented capabilities, but some format and delivery internals are unsampled, so uncertain connections are omitted.
Main entry points: CLIExportEngine.swift CLI export engine · NotesRepository.swift Notes repository · ExportViewModel.swift GUI export · AppleNotesExporterView.swift Exporter app
Components 21
User interfaces
- Exporter app
Apple Notes Exporter/Apple Notes Exporter/AppleNotesExporterView.swift - Note selection
Apple Notes Exporter/Apple Notes Exporter/ViewModels/NotesViewModel.swift - Hierarchy selector
Apple Notes Exporter/Apple Notes Exporter/NoteSelectorView.swift - GUI export
Apple Notes Exporter/Apple Notes Exporter/ViewModels/ExportViewModel.swift - CLI commands
Apple Notes Exporter/Apple Notes Exporter CLI/Commands/ExportCommand.swift
Notes access
- Notes repository
Apple Notes Exporter/Apple Notes Exporter/Repository/NotesRepository.swift - Notes database bridge
Apple Notes Exporter/Apple Notes Exporter/AppleNotesKit/AppleNotesKit.h - Table parser
Apple Notes Exporter/Apple Notes Exporter/TableParser.swift
Export and conversion
- CLI export engine
Apple Notes Exporter/Apple Notes Exporter CLI/CLIExportEngine.swift - Note formatters
Apple Notes Exporter/Apple Notes Exporter/Models/NotesNote+Export.swift - HTML generator
Apple Notes Exporter/Apple Notes Exporter/NoteHTMLGenerator.swift - Attachment processing
Apple Notes Exporter/Apple Notes Exporter/HTMLAttachmentProcessor.swift
Delivery and sync
- Output delivery
Apple Notes Exporter/Apple Notes Exporter/ExportSupport.swift - Sync manifest
Apple Notes Exporter/Apple Notes Exporter/Models/SyncManifest.swift
Automation interfaces
- Shortcuts actions
Apple Notes Exporter/Apple Notes Exporter/AppIntents.swift - MCP server
Apple Notes Exporter/Apple Notes Exporter MCP/NotesMCPServer.swift - MCP tools
Apple Notes Exporter/Apple Notes Exporter MCP/MCPToolHandlers.swift
Other components
- GUI user
- CLI user
- AI assistant
- Apple Notes store
Connections 23
- GUI user → Exporter app: uses
README.md - Exporter app → Note selection: loads notes
Apple Notes Exporter/Apple Notes Exporter/AppleNotesExporterView.swift - Exporter app → GUI export: starts export
Apple Notes Exporter/Apple Notes Exporter/AppleNotesExporterView.swift - Exporter app → Hierarchy selector: presents selection
Apple Notes Exporter/Apple Notes Exporter/AppleNotesExporterView.swift - Note selection → Notes repository: fetches notes
Apple Notes Exporter/Apple Notes Exporter/ViewModels/NotesViewModel.swift - Notes repository → Notes database bridge: reads store
- Notes repository → Apple Notes store: queries
Apple Notes Exporter/Apple Notes Exporter/Repository/NotesRepository.swift - Notes repository → HTML generator: generates HTML
Apple Notes Exporter/Apple Notes Exporter/Repository/NotesRepository.swift - CLI user → CLI commands: runs command
README.md - CLI commands → CLI export engine: requests export
Apple Notes Exporter/Apple Notes Exporter CLI/Commands/ExportCommand.swift - CLI export engine → Notes repository: fetches notes
Apple Notes Exporter/Apple Notes Exporter CLI/CLIExportEngine.swift - GUI export → Notes repository: fetches note HTML
Apple Notes Exporter/Apple Notes Exporter/ViewModels/ExportViewModel.swift - GUI export → Attachment processing: processes attachments
Apple Notes Exporter/Apple Notes Exporter/ViewModels/ExportViewModel.swift - GUI export → Sync manifest: tracks incremental runs
Apple Notes Exporter/Apple Notes Exporter/ViewModels/ExportViewModel.swift - CLI export engine → Sync manifest: tracks incremental runs
Apple Notes Exporter/Apple Notes Exporter CLI/CLIExportEngine.swift - CLI export engine → Attachment processing: processes attachments
Apple Notes Exporter/Apple Notes Exporter CLI/CLIExportEngine.swift - GUI export → Output delivery: delivers files
- CLI export engine → Output delivery: delivers files
- Shortcuts actions → CLI export engine: uses shared engine
README.md - AI assistant → MCP server: connects
README.md - MCP server → MCP tools: dispatches tools
Apple Notes Exporter/Apple Notes Exporter MCP/NotesMCPServer.swift - MCP tools → CLI export engine: exports notes
Apple Notes Exporter/Apple Notes Exporter MCP/MCPToolHandlers.swift - Note formatters → Table parser: parses embedded tables