apple-notes-mcp 2.8.8 → 2.8.10

package/README.md

@@ -58,6 +58,19 @@ This method also installs a **skill** that teaches Claude when and how to use Ap
 
 On the first tool call, macOS shows an Automation permission prompt ("Claude" wants access to control "Notes") — click **OK**. Optionally, grant **Full Disk Access** to the app that launches the server to enable the database-backed tools (`get-checklist-state`, `get-note-metadata`, `get-note-link`, checklist annotations in `get-note-markdown`, and full `get-sync-status` detail); see the [Full Disk Access Setup Guide](https://github.com/sweetrb/apple-notes-mcp/blob/main/docs/FULL-DISK-ACCESS.md). The rest of the server is pure AppleScript and works without it.
 
+Native tag, checklist, table, pin, and rich append operations use two packaged
+Apple Shortcuts. Run the explicit setup once:
+
+```bash
+npx -y apple-notes-mcp setup
+```
+
+The command checks existing installations and opens only missing signed
+workflows. Confirm **Add Shortcut** in each macOS window, then verify with
+`npx -y apple-notes-mcp setup --check` or the MCP `doctor` tool. macOS does not
+support silent Shortcut import, so merely connecting an MCP client never opens
+setup windows or bypasses these confirmations.
+
 ### Using the Codex Marketplace
 
 The same plugin is available for Codex. Add the marketplace and install the plugin:
@@ -988,6 +1001,58 @@ Lists all notes shared with collaborators.
 
 ---
 
+### Native background operations
+
+Install the signed workflows once as described in
+[`shortcuts/README.md`](shortcuts/README.md). Native writes never use UI
+automation or write directly to the Notes database. Every operation requires an
+exact note ID, a fresh `expectedContentHash`, and a distinctive existing
+`scopeText` so the Shortcut and server can independently resolve the same note.
+
+#### `get-capabilities`
+
+Reports which background operations are implemented, live-verified, installed,
+and currently available, with a specific reason for each unavailable operation.
+
+#### `append-native`
+
+Appends bounded plaintext, semantic HTML, or Markdown while preserving existing
+native objects. The regular `append-to-note` tool routes protected notes here
+when `scopeText` is supplied. Use a distinctive phrase of plain words without
+punctuation, hashtags, or paths because Notes search may not resolve them
+literally.
+
+#### `create-checklist-item`
+
+Appends one real unchecked Notes checklist item and verifies its native identity
+and text.
+
+#### `create-table`
+
+Appends a native table from rectangular string rows and verifies every decoded
+cell. It never substitutes a text table.
+
+#### `set-note-pinned`
+
+Sets an explicit pinned state after checking both the expected current state and
+the note revision. It does not rewrite the body.
+
+#### `remove-native-tags`
+
+Removes specified tags from one exact note while preserving unrelated tags and
+native objects. It does not delete global tag definitions.
+
+#### `replace-native-tag`
+
+Adds and verifies the new tag before removing the old tag on an explicit list of
+freshly read notes. Stops on the first uncertain result. Smart Folder rules are
+not changed.
+
+#### `insert-note-link`
+
+Retrieves another note's real deep link and appends it with a static label while
+preserving the target note's native objects.
+
 ## Usage Patterns
 
 ### Basic Workflow