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 +70 -0
- package/build/index.js +1228 -335
- package/package.json +2 -1
- package/shortcuts/Apple Notes MCP - Background Operations v5.shortcut +0 -0
- package/shortcuts/Apple Notes MCP - Background Operations v5.unsigned.shortcut +2546 -0
- package/shortcuts/Apple Notes MCP - Native Tags.shortcut +0 -0
- package/shortcuts/Apple Notes MCP - Native Tags.unsigned.shortcut +563 -0
- package/shortcuts/README.md +43 -0
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
|