notes

Tools for working with Apple Notes: bulk export to markdown and an MCP server for LLM access.

Install

bun install

Export

Bulk-export all Apple Notes to markdown files with images and folder structure preserved.

bun export-notes.ts

By default notes are exported to ./exported. Use -o to specify a custom output folder:

bun export-notes.ts -o ~/Documents/my-notes

• Fetches all notes from Apple Notes (all accounts, nested folders)

• Converts HTML to markdown

• Extracts embedded images to an images/ subfolder

• Preserves folder hierarchy (e.g. Row/Test/folder note.md)

• Adds YAML frontmatter (title, dates, folder, account)

MCP Server

An MCP server that lets LLMs read and write Apple Notes directly.

bun mcp-server.ts

Tools

• list_notes — list all notes with metadata; optional search filter (matches name and folder)

• get_note — fetch a single note as markdown with YAML frontmatter

• create_note — create a new note from markdown

• add_to_note — append markdown to an existing note (preserves existing formatting)

Usage with Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "apple-notes": {
      "command": "bun",
      "args": ["mcp-server.ts"],
      "cwd": "/path/to/notes"
    }
  }
}

Testing

npx @modelcontextprotocol/inspector bun mcp-server.ts