apple-notes-mcp 2.2.0 → 2.4.0

package/README.md

@@ -267,6 +267,22 @@ see [docs/APPLESCRIPT-LIMITATIONS.md](../docs/APPLESCRIPT-LIMITATIONS.md#tags--h
 
 ---
 
+#### `get-note-plaintext`
+
+Retrieves a note's body as plain text, with no HTML markup.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | No | Note ID (preferred - more reliable than title) |
+| `title` | string | No | Note title (use `id` instead when available) |
+| `account` | string | No | Account containing the note (defaults to iCloud, ignored if `id` is provided) |
+
+**Note:** Either `id` or `title` must be provided. This reads the note's native `plaintext` property, so it skips the HTML-to-text conversion that `get-note-content` plus a Markdown pass would do. Use `get-note-content` when you need the HTML, or `get-note-markdown` when you want Markdown with checklist state.
+
+**Returns:** The plain-text content of the note in `structuredContent.plaintext`, or error if not found.
+
+---
+
 #### `get-note-details`
 
 Retrieves metadata about a note (without full content).
@@ -376,6 +392,8 @@ Updates an existing note's content and/or title.
 
 **Note:** `newContent` **replaces the entire note body** — it is not appended. To preserve existing content, read it first (e.g. with `get-note-content`) and include it in `newContent`.
 
+**Attachments:** A full-body replace can drop embedded files, images, scans, PDFs, or audio. When a note may hold attachments, run [`list-attachments`](#list-attachments) first, and either save them with `save-attachment` or build a new note rather than overwriting. See the skill's [Attachment-Safe Updates](skills/apple-notes/SKILL.md#attachment-safe-updates) guidance.
+
 ---
 
 #### `delete-note`
@@ -551,6 +569,19 @@ Deletes a folder.
 
 ---
 
+#### `show-folder`
+
+Reveals a folder in Notes.app using its unique CoreData identifier.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | Yes | The folder's CoreData identifier (from `list-folders`) |
+| `separately` | boolean | No | Open in a separate window when supported by Notes.app |
+
+**Returns:** Confirmation that Notes.app accepted the show command.
+
+---
+
 ### Account Operations
 
 #### `list-accounts`
@@ -578,6 +609,19 @@ Returns the default account and folder Notes.app uses for newly created notes.
 
 ---
 
+#### `show-account`
+
+Reveals an account in Notes.app using its unique CoreData identifier.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | Yes | The account's CoreData identifier (from `list-accounts`) |
+| `separately` | boolean | No | Open in a separate window when supported by Notes.app |
+
+**Returns:** Confirmation that Notes.app accepted the show command.
+
+---
+
 ### Batch Operations
 
 #### `batch-delete-notes`
@@ -703,6 +747,20 @@ Returns a note attachment's bytes as base64, without writing to disk (the read c
 
 ---
 
+#### `show-attachment`
+
+Reveals one note attachment in Notes.app. Attachments are elements of a note, so this takes both the note id and the attachment id (the same pair used by `save-attachment` / `fetch-attachment`).
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `noteId` | string | Yes | CoreData note ID (from `search-notes`/`list-notes`) |
+| `attachmentId` | string | Yes | Attachment ID (from `list-attachments`) |
+| `separately` | boolean | No | Open in a separate window when supported by Notes.app |
+
+**Returns:** Confirmation that Notes.app revealed the attachment.
+
+---
+
 ### Diagnostics
 
 #### `health-check`