# notes

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

## Install

```bash
bun install
```

## Export

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

```bash
bun export-notes.ts
```

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

```bash
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.

```bash
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`:

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

### Testing

```bash
npx @modelcontextprotocol/inspector bun mcp-server.ts
```