apple-notes-mcp 2.8.7 → 2.8.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -323,6 +323,24 @@ Access.
323
323
 
324
324
  ---
325
325
 
326
+ #### `native-tags-status`
327
+
328
+ Checks whether exactly one configured Native Tags Shortcut is installed. An
329
+ installed workflow may still need macOS permission on its first execution.
330
+
331
+ ---
332
+
333
+ #### `add-native-tags`
334
+
335
+ Adds actual native Notes tag objects to one exact note using `id`, a fresh
336
+ `expectedContentHash`, a distinctive existing `scopeText`, and `tags`. The
337
+ operation verifies the note's original text, links, and native objects after the
338
+ Shortcut runs. It refuses ambiguous title-and-scope matches and never retries an
339
+ uncertain write. Install the signed workflow as described in
340
+ [`shortcuts/README.md`](shortcuts/README.md).
341
+
342
+ ---
343
+
326
344
  #### `get-note-plaintext`
327
345
 
328
346
  Retrieves a note's body as plain text, with no HTML markup.
@@ -970,6 +988,58 @@ Lists all notes shared with collaborators.
970
988
 
971
989
  ---
972
990
 
991
+ ### Native background operations
992
+
993
+ Install the signed workflows once as described in
994
+ [`shortcuts/README.md`](shortcuts/README.md). Native writes never use UI
995
+ automation or write directly to the Notes database. Every operation requires an
996
+ exact note ID, a fresh `expectedContentHash`, and a distinctive existing
997
+ `scopeText` so the Shortcut and server can independently resolve the same note.
998
+
999
+ #### `get-capabilities`
1000
+
1001
+ Reports which background operations are implemented, live-verified, installed,
1002
+ and currently available, with a specific reason for each unavailable operation.
1003
+
1004
+ #### `append-native`
1005
+
1006
+ Appends bounded plaintext, semantic HTML, or Markdown while preserving existing
1007
+ native objects. The regular `append-to-note` tool routes protected notes here
1008
+ when `scopeText` is supplied. Use a distinctive phrase of plain words without
1009
+ punctuation, hashtags, or paths because Notes search may not resolve them
1010
+ literally.
1011
+
1012
+ #### `create-checklist-item`
1013
+
1014
+ Appends one real unchecked Notes checklist item and verifies its native identity
1015
+ and text.
1016
+
1017
+ #### `create-table`
1018
+
1019
+ Appends a native table from rectangular string rows and verifies every decoded
1020
+ cell. It never substitutes a text table.
1021
+
1022
+ #### `set-note-pinned`
1023
+
1024
+ Sets an explicit pinned state after checking both the expected current state and
1025
+ the note revision. It does not rewrite the body.
1026
+
1027
+ #### `remove-native-tags`
1028
+
1029
+ Removes specified tags from one exact note while preserving unrelated tags and
1030
+ native objects. It does not delete global tag definitions.
1031
+
1032
+ #### `replace-native-tag`
1033
+
1034
+ Adds and verifies the new tag before removing the old tag on an explicit list of
1035
+ freshly read notes. Stops on the first uncertain result. Smart Folder rules are
1036
+ not changed.
1037
+
1038
+ #### `insert-note-link`
1039
+
1040
+ Retrieves another note's real deep link and appends it with a static label while
1041
+ preserving the target note's native objects.
1042
+
973
1043
  ## Usage Patterns
974
1044
 
975
1045
  ### Basic Workflow