apple-mcp-notes 1.0.1__py3-none-any.whl

apple_mcp_notes-1.0.1.dist-info/METADATA

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: apple-mcp-notes
+Version: 1.0.1
+Summary: Local Apple Notes MCP server for macOS
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/JonathanRReed/Apple-MCPs
+Project-URL: Repository, https://github.com/JonathanRReed/Apple-MCPs
+Project-URL: Changelog, https://github.com/JonathanRReed/Apple-MCPs/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/JonathanRReed/Apple-MCPs/issues
+Keywords: mcp,model-context-protocol,macos,apple,ai-agent,automation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: apple-mcp-common<2,>=1.0.0
+Requires-Dist: mcp<3,>=2.0.0
+Requires-Dist: pydantic>=2.12.0
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: ruff<1,>=0.12; extra == "dev"
+Dynamic: license-file
+
+<!-- mcp-name: io.github.jonathanrreed/apple-mcp-notes -->
+
+# Apple Notes MCP
+
+MCP server for Apple Notes on macOS.
+
+Provides access to notes and folders for creation, organization, and management. Keep Notes as the system of record while enabling agents to read, create, update, move, and delete notes.
+
+## When to use
+
+- Notes-only workflows
+- Stronger isolation than the all-in-one server
+- Structured note and folder operations through the native Notes app
+
+## What It Does
+
+- List accounts and folders
+- List, search, and manage notes (CRUD)
+- Create, rename, and delete folders
+- List note attachments
+- Tool discovery helpers `search_tools` and `get_tool_info` for context-constrained clients
+- Recent-note resources and organization prompts
+- Health and permission checks: `notes_health`, `notes_permission_guide`, `notes_recheck_permissions`
+
+## Install On This Mac
+
+<details>
+<summary>Quick start (uvx, from PyPI)</summary>
+
+With [uv](https://docs.astral.sh/uv/getting-started/installation/) installed:
+
+```bash
+uvx apple-mcp-notes
+```
+
+No clone, no venv management.
+
+</details>
+
+<details>
+<summary>From a clone</summary>
+
+```bash
+git clone https://github.com/JonathanRReed/Apple-MCPs.git
+cd Apple-MCPs
+uv sync --all-packages
+```
+
+This builds one workspace environment with every server's entry point in `.venv/bin` (for example `.venv/bin/apple-notes-mcp`). You can also point an MCP client at `AppleNotes-MCP/start.sh`, which prefers `uv run` and falls back to a plain venv bootstrap (Python 3.11+ required).
+
+</details>
+
+## Install In AI Agents
+
+<details>
+<summary>Generic MCP client config</summary>
+
+```json
+{
+  "mcpServers": {
+    "apple-notes": {
+      "command": "uvx",
+      "args": ["apple-mcp-notes"],
+      "env": {
+        "APPLE_NOTES_MCP_SAFETY_MODE": "full_access"
+      }
+    }
+  }
+}
+```
+
+Running from a clone instead? Use `/path/to/Apple-MCPs/AppleNotes-MCP/start.sh` as the command with empty `args`.
+
+</details>
+
+<details>
+<summary>Claude Code example</summary>
+
+```bash
+claude mcp add --transport stdio --scope project apple-notes -- uvx apple-mcp-notes
+```
+
+</details>
+
+## Safety Modes
+
+- `safe_readonly`
+- `safe_manage`
+- `full_access`
+
+## Transport
+
+`stdio` is the default and recommended transport. Set `APPLE_NOTES_MCP_TRANSPORT=streamable-http` (with optional `APPLE_NOTES_MCP_HOST` and `APPLE_NOTES_MCP_PORT`) to serve Streamable HTTP instead.
+
+## macOS Permissions
+
+- Automation access to Notes is required
+
+## Launch Checklist
+
+- Add `uvx apple-mcp-notes` (or a clone's `AppleNotes-MCP/start.sh`) to your MCP client
+- Reload or reconnect the client so the Notes tool surface is loaded into context
+- Call `notes_health` first
+- If Notes automation is blocked, call `notes_permission_guide`
+- After changing macOS permissions, call `notes_recheck_permissions`
+
+## Prompting Notes
+
+- `tools/list` returns the full Notes tool surface. Context-constrained clients can use `search_tools` first, then `get_tool_info` for the Notes tool they need.
+- Multiple accounts may each contain a Notes folder. Identify available accounts and folders on first use and set a default.
+- Use Notes for reference material and saved context.
+- Time-sensitive items should go to Reminders or Calendar instead.
+
+## Related
+
+- [Apple-Tools-MCP](../Apple-Tools-MCP/README.md)

apple_mcp_notes-1.0.1.dist-info/RECORD

@@ -0,0 +1,24 @@
+apple_mcp_notes-1.0.1.dist-info/licenses/LICENSE,sha256=ekujwdbi9SDNikrkciCPMsNSOSdrRCF_-fxh9Z1hUHw,1079
+apple_notes_mcp/__init__.py,sha256=4t_crzhrLum--oyowUMxtjBTzUtWp7oRTF22ewEvJG4,49
+apple_notes_mcp/config.py,sha256=x7U7DwhB8Ueo5ypXZKfyms3nJYRC0qnSu1H4ej8X7Oo,1454
+apple_notes_mcp/models.py,sha256=llZkz7fZ7L9Ec_gajWsgIEfjlP4g-V2TyfO1C94SZ0U,3001
+apple_notes_mcp/notes_bridge.py,sha256=3j7R2PvVFQJuvPnhU9-EDQHX5zV_jAVFJqSrukUI_S8,15860
+apple_notes_mcp/permissions.py,sha256=ZcVjKzaDwzOSFc6J1d9SJZDZ5_SwE3uofoZMC5MMgcM,2671
+apple_notes_mcp/tools.py,sha256=ZF5bzTIkH1KhDD1UMI8R3cQatJ6omwfpV_vcxbcJ9QU,23000
+apple_notes_mcp/applescripts/create_folder.applescript,sha256=Y2fDZzWWTNiqJL5SPyao9DkTDBgUBUw2FbuRfydaJmk,2154
+apple_notes_mcp/applescripts/create_note.applescript,sha256=S703RZPs7X3QoxKFB5klaMOUge6mRVzuOHst297zVzI,4510
+apple_notes_mcp/applescripts/delete_folder.applescript,sha256=Sztrwq6IUGzUKG2KPPtrE-ItxWrTlWE5PeXHvVjGsmo,1438
+apple_notes_mcp/applescripts/delete_note.applescript,sha256=tbHnbtvtvoBVZuv64KdnXtI2mW9mpto_GHM1fbnYtic,1334
+apple_notes_mcp/applescripts/get_note.applescript,sha256=Y_yDotU_8Jc9RcQylgRbm4x_sdttMXXPQA_oEwQ3CMk,4035
+apple_notes_mcp/applescripts/list_accounts.applescript,sha256=pwt7d3MhY7Y_IoqUGdLHHCtVMn7m3XvoRXd_Lhcrkkw,2374
+apple_notes_mcp/applescripts/list_attachments.applescript,sha256=d-voJnSSsWnJSiMPNDouXk9yl08XATV4StuzAS3C_6Q,2077
+apple_notes_mcp/applescripts/list_folders.applescript,sha256=weKjh6UUnNfbBih1xR_xeGKGLm2Xwr0a_WAmqGCEUgg,3360
+apple_notes_mcp/applescripts/list_notes.applescript,sha256=ErZQMjl7D_xZBpGr2IRZF7LisIQK9EdXCs3oHL1r7WU,4051
+apple_notes_mcp/applescripts/move_note.applescript,sha256=Vrx4wf47B7Y1MzK5eJY_x9JpbJqBUsjGBOJ9KtWXpu4,2110
+apple_notes_mcp/applescripts/rename_folder.applescript,sha256=RR4Y9pUsfCUMJQQr0cRQJp0uQUkbEBcBslxoharDvz4,1907
+apple_notes_mcp/applescripts/update_note.applescript,sha256=gpfR16rD3toIvq9EQsq-m0i2s74IP2tyfSmyTeqsBNA,5918
+apple_mcp_notes-1.0.1.dist-info/METADATA,sha256=SKCwo_whqTNtstu99S1mX7OZJcIXwtuyw1alqPh9Vw4,4561
+apple_mcp_notes-1.0.1.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+apple_mcp_notes-1.0.1.dist-info/entry_points.txt,sha256=phdDfjPQTSQ0szSW9a7blQMdMKoi20AVeMgFGKxiK7s,108
+apple_mcp_notes-1.0.1.dist-info/top_level.txt,sha256=I_grA1vZ8IsRbKFRFwcIDLkxbg6yAMEYOZnENWoX9EY,16
+apple_mcp_notes-1.0.1.dist-info/RECORD,,

apple_mcp_notes-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

apple_mcp_notes-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+apple-mcp-notes = apple_notes_mcp.tools:main
+apple-notes-mcp = apple_notes_mcp.tools:main

apple_mcp_notes-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Apple MCP Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

apple_mcp_notes-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+apple_notes_mcp

apple_notes_mcp/__init__.py

@@ -0,0 +1,3 @@
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

apple_notes_mcp/applescripts/create_folder.applescript

@@ -0,0 +1,50 @@
+on run argv
+	set folderName to item 1 of argv
+	set accountName to item 2 of argv
+	set parentFolderId to item 3 of argv
+	tell application "Notes"
+		set targetAccount to account accountName
+		if parentFolderId is not "" then
+			set targetFolder to folder id parentFolderId
+			set newFolder to make new folder at targetFolder with properties {name:folderName}
+		else
+			set newFolder to make new folder at targetAccount with properties {name:folderName}
+		end if
+		return "{" & quote & "folder" & quote & ":" & my folder_json(newFolder, targetAccount) & "}"
+	end tell
+end run
+
+on folder_json(fld, acc)
+	set folderId to my safe_text(id of fld)
+	set folderName to my safe_text(name of fld)
+	set accountId to my safe_text(id of acc)
+	set accountName to my safe_text(name of acc)
+	return "{" & quote & "folder_id" & quote & ":" & my json_string(folderId) & "," & quote & "name" & quote & ":" & my json_string(folderName) & "," & quote & "account_id" & quote & ":" & my json_string(accountId) & "," & quote & "account_name" & quote & ":" & my json_string(accountName) & "," & quote & "parent_folder_id" & quote & ":null," & quote & "parent_folder_name" & quote & ":null," & quote & "shared" & quote & ":false}"
+end folder_json
+
+on safe_text(valueText)
+	try
+		return valueText as text
+	on error
+		return ""
+	end try
+end safe_text
+
+on json_string(valueText)
+	set backslash to ASCII character 92
+	set escapedText to my replace_text(valueText as text, backslash, backslash & backslash)
+	set escapedText to my replace_text(escapedText, quote, backslash & quote)
+	set escapedText to my replace_text(escapedText, return, backslash & "n")
+	set escapedText to my replace_text(escapedText, linefeed, backslash & "n")
+	return quote & escapedText & quote
+end json_string
+
+on replace_text(sourceText, findText, replaceText)
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to findText
+	set sourceItems to text items of sourceText
+	set AppleScript's text item delimiters to replaceText
+	set resultText to sourceItems as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return resultText
+end replace_text

apple_notes_mcp/applescripts/create_note.applescript

@@ -0,0 +1,130 @@
+on run argv
+	set titleText to item 1 of argv
+	set folderId to item 2 of argv
+	set bodyHtml to item 3 of argv
+	set tagsCsv to item 4 of argv
+	tell application "Notes"
+		set folderInfo to my find_folder_info(folderId)
+		if folderInfo is missing value then error "Can't get folder '" & folderId & "'."
+		set targetFolder to item 1 of folderInfo
+		set accountId to item 2 of folderInfo
+		set accountName to item 3 of folderInfo
+		set folderName to item 4 of folderInfo
+		set noteBody to my compose_note_body(bodyHtml, tagsCsv)
+		set newNote to make new note at targetFolder with properties {name:titleText}
+		if noteBody is not "" then
+			set body of newNote to noteBody
+		end if
+		return "{" & quote & "note" & quote & ":" & my note_json(accountId, accountName, folderId, folderName, newNote) & "}"
+	end tell
+end run
+
+on find_folder_info(targetFolderId)
+	tell application "Notes"
+		repeat with acc in accounts
+			set accountId to my safe_text(id of acc)
+			set accountName to my safe_text(name of acc)
+			repeat with fld in folders of acc
+				if my safe_text(id of fld) is targetFolderId then
+					return {fld, accountId, accountName, my safe_text(name of fld)}
+				end if
+			end repeat
+		end repeat
+	end tell
+	return missing value
+end find_folder_info
+
+on compose_note_body(bodyHtml, tagsCsv)
+	set noteBody to bodyHtml
+	if tagsCsv is not "" then
+		set noteBody to noteBody & "<div><br></div><div>" & my tags_html(tagsCsv) & "</div>"
+	end if
+	return noteBody
+end compose_note_body
+
+on tags_html(tagsCsv)
+	set AppleScript's text item delimiters to ","
+	set tagItems to text items of tagsCsv
+	set AppleScript's text item delimiters to ""
+	set htmlTags to {}
+	repeat with tagItem in tagItems
+		set cleanTag to my safe_text(tagItem)
+		if cleanTag is not "" then
+			set end of htmlTags to "#" & cleanTag
+		end if
+	end repeat
+	return my join_list(htmlTags, " ")
+end tags_html
+
+on note_json(accountId, accountName, folderId, folderName, n)
+	set noteId to my safe_text(id of n)
+	set titleText to ""
+	set bodyHtml to ""
+	set plainText to ""
+	set attachmentCount to 0
+	try
+		set titleText to my safe_text(name of n)
+	end try
+	try
+		set bodyHtml to my safe_text(body of n)
+	end try
+	try
+		set plainText to my safe_text(plaintext of n)
+	end try
+	try
+		set attachmentCount to count of attachments of n
+	end try
+	return "{" & ¬
+		quote & "note_id" & quote & ":" & my json_string(noteId) & "," & ¬
+		quote & "title" & quote & ":" & my json_string(titleText) & "," & ¬
+		quote & "account_id" & quote & ":" & my json_string(accountId) & "," & ¬
+		quote & "account_name" & quote & ":" & my json_string(accountName) & "," & ¬
+		quote & "folder_id" & quote & ":" & my json_string(folderId) & "," & ¬
+		quote & "folder_name" & quote & ":" & my json_string(folderName) & "," & ¬
+		quote & "created_epoch" & quote & ":0," & ¬
+		quote & "modified_epoch" & quote & ":0," & ¬
+		quote & "password_protected" & quote & ":false," & ¬
+		quote & "shared" & quote & ":false," & ¬
+		quote & "attachment_count" & quote & ":" & attachmentCount & "," & ¬
+		quote & "plaintext" & quote & ":" & my json_string(plainText) & "," & ¬
+		quote & "body_html" & quote & ":" & my json_string(bodyHtml) & "," & ¬
+		quote & "attachments" & quote & ":[]}"
+end note_json
+
+on safe_text(valueText)
+	try
+		return valueText as text
+	on error
+		return ""
+	end try
+end safe_text
+
+on json_string(valueText)
+	set backslash to ASCII character 92
+	set escapedText to my replace_text(valueText as text, backslash, backslash & backslash)
+	set escapedText to my replace_text(escapedText, quote, backslash & quote)
+	set escapedText to my replace_text(escapedText, return, backslash & "n")
+	set escapedText to my replace_text(escapedText, linefeed, backslash & "n")
+	return quote & escapedText & quote
+end json_string
+
+on replace_text(sourceText, findText, replaceText)
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to findText
+	set sourceItems to text items of sourceText
+	set AppleScript's text item delimiters to replaceText
+	set resultText to sourceItems as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return resultText
+end replace_text
+
+on join_list(itemList, delimiterText)
+	if (count of itemList) is 0 then
+		return ""
+	end if
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to delimiterText
+	set joinedText to itemList as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return joinedText
+end join_list

apple_notes_mcp/applescripts/delete_folder.applescript

@@ -0,0 +1,42 @@
+on run argv
+	set folderId to item 1 of argv
+	tell application "Notes"
+		repeat with acc in accounts
+			repeat with fld in folders of acc
+				if my safe_text(id of fld) is folderId then
+					delete fld
+					return "{" & quote & "deleted" & quote & ":true," & quote & "folder_id" & quote & ":" & my json_string(folderId) & "}"
+				end if
+			end repeat
+		end repeat
+	end tell
+	return "{" & quote & "deleted" & quote & ":false," & quote & "folder_id" & quote & ":" & my json_string(folderId) & "}"
+end run
+
+on safe_text(valueText)
+	try
+		return valueText as text
+	on error
+		return ""
+	end try
+end safe_text
+
+on json_string(valueText)
+	set backslash to ASCII character 92
+	set escapedText to my replace_text(valueText as text, backslash, backslash & backslash)
+	set escapedText to my replace_text(escapedText, quote, backslash & quote)
+	set escapedText to my replace_text(escapedText, return, backslash & "n")
+	set escapedText to my replace_text(escapedText, linefeed, backslash & "n")
+	return quote & escapedText & quote
+end json_string
+
+on replace_text(sourceText, findText, replaceText)
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to findText
+	set sourceItems to text items of sourceText
+	set AppleScript's text item delimiters to replaceText
+	set resultText to sourceItems as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return resultText
+end replace_text
+

apple_notes_mcp/applescripts/delete_note.applescript

@@ -0,0 +1,38 @@
+on run argv
+	set targetNoteId to item 1 of argv
+	tell application "Notes"
+		try
+			delete note id targetNoteId
+			return "{" & quote & "deleted" & quote & ":true," & quote & "note_id" & quote & ":" & my json_string(targetNoteId) & "}"
+		on error
+			return "{" & quote & "deleted" & quote & ":false," & quote & "note_id" & quote & ":" & my json_string(targetNoteId) & "}"
+		end try
+	end tell
+end run
+
+on safe_text(valueText)
+	try
+		return valueText as text
+	on error
+		return ""
+	end try
+end safe_text
+
+on json_string(valueText)
+	set backslash to ASCII character 92
+	set escapedText to my replace_text(valueText as text, backslash, backslash & backslash)
+	set escapedText to my replace_text(escapedText, quote, backslash & quote)
+	set escapedText to my replace_text(escapedText, return, backslash & "n")
+	set escapedText to my replace_text(escapedText, linefeed, backslash & "n")
+	return quote & escapedText & quote
+end json_string
+
+on replace_text(sourceText, findText, replaceText)
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to findText
+	set sourceItems to text items of sourceText
+	set AppleScript's text item delimiters to replaceText
+	set resultText to sourceItems as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return resultText
+end replace_text

apple_notes_mcp/applescripts/get_note.applescript

@@ -0,0 +1,122 @@
+on run argv
+	set targetNoteId to item 1 of argv
+	set foundJson to ""
+	tell application "Notes"
+		repeat with acc in accounts
+			set accName to my safe_text(name of acc)
+			set accId to my safe_text(id of acc)
+			repeat with fld in folders of acc
+				set fldId to my safe_text(id of fld)
+				set fldName to my safe_text(name of fld)
+				repeat with n in notes of fld
+					if my safe_text(id of n) is targetNoteId then
+						set foundJson to "{" & quote & "found" & quote & ":true," & quote & "note" & quote & ":" & my note_json(accId, accName, fldId, fldName, n, true) & "}"
+						exit repeat
+					end if
+				end repeat
+				if foundJson is not "" then exit repeat
+			end repeat
+			if foundJson is not "" then exit repeat
+		end repeat
+	end tell
+	if foundJson is "" then
+		return "{" & quote & "found" & quote & ":false}"
+	end if
+	return foundJson
+end run
+
+on note_json(accountId, accountName, folderId, folderName, n, includeBody)
+	set noteId to my safe_text(id of n)
+	set titleText to ""
+	set bodyHtml to ""
+	set plainText to ""
+	set createdEpoch to 0
+	set modifiedEpoch to 0
+		set sharedValue to false
+		try
+			set titleText to my safe_text(name of n)
+		end try
+	try
+		set bodyHtml to my safe_text(body of n)
+	end try
+	try
+		set plainText to my safe_text(plaintext of n)
+	end try
+	try
+		set createdEpoch to my date_to_epoch(creation date of n)
+	end try
+	try
+		set modifiedEpoch to my date_to_epoch(modification date of n)
+	end try
+		try
+			set sharedValue to shared of n
+		end try
+	return "{" & ¬
+		quote & "note_id" & quote & ":" & my json_string(noteId) & "," & ¬
+		quote & "title" & quote & ":" & my json_string(titleText) & "," & ¬
+		quote & "account_id" & quote & ":" & my json_string(accountId) & "," & ¬
+		quote & "account_name" & quote & ":" & my json_string(accountName) & "," & ¬
+		quote & "folder_id" & quote & ":" & my json_string(folderId) & "," & ¬
+		quote & "folder_name" & quote & ":" & my json_string(folderName) & "," & ¬
+		quote & "created_epoch" & quote & ":" & createdEpoch & "," & ¬
+		quote & "modified_epoch" & quote & ":" & modifiedEpoch & "," & ¬
+			quote & "shared" & quote & ":" & my json_boolean(sharedValue) & "," & ¬
+		quote & "attachment_count" & quote & ":0," & ¬
+		quote & "plaintext" & quote & ":" & my json_string(plainText) & "," & ¬
+		quote & "body_html" & quote & ":" & my json_string(bodyHtml) & "," & ¬
+		quote & "attachments" & quote & ":[]}"
+end note_json
+
+on date_to_epoch(dateValue)
+	set epochDate to current date
+	set year of epochDate to 1970
+	set month of epochDate to January
+	set day of epochDate to 1
+	set time of epochDate to 0
+	return (dateValue - epochDate) as integer
+end date_to_epoch
+
+on safe_text(valueText)
+	try
+		return valueText as text
+	on error
+		return ""
+	end try
+end safe_text
+
+on json_boolean(boolValue)
+	if boolValue then
+		return "true"
+	end if
+	return "false"
+end json_boolean
+
+on json_string(valueText)
+	set backslash to ASCII character 92
+	set escapedText to my replace_text(valueText as text, backslash, backslash & backslash)
+	set escapedText to my replace_text(escapedText, quote, backslash & quote)
+	set escapedText to my replace_text(escapedText, return, backslash & "n")
+	set escapedText to my replace_text(escapedText, linefeed, backslash & "n")
+	return quote & escapedText & quote
+end json_string
+
+on replace_text(sourceText, findText, replaceText)
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to findText
+	set sourceItems to text items of sourceText
+	set AppleScript's text item delimiters to replaceText
+	set resultText to sourceItems as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return resultText
+end replace_text
+
+on join_list(itemList, delimiterText)
+	if (count of itemList) is 0 then
+		return ""
+	end if
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to delimiterText
+	set joinedText to itemList as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return joinedText
+end join_list

apple_notes_mcp/applescripts/list_accounts.applescript

@@ -0,0 +1,75 @@
+on run argv
+	set jsonItems to {}
+	tell application "Notes"
+		repeat with acc in accounts
+			set accName to my safe_text(name of acc)
+			set accId to my safe_text(id of acc)
+			set upgradedValue to false
+			try
+				set upgradedValue to upgraded of acc
+			end try
+			set defaultFolderId to ""
+			try
+				set defaultFolderId to my safe_text(id of default folder of acc)
+			end try
+			set end of jsonItems to "{" & ¬
+				quote & "account_id" & quote & ":" & my json_string(accId) & "," & ¬
+				quote & "name" & quote & ":" & my json_string(accName) & "," & ¬
+				quote & "upgraded" & quote & ":" & my json_boolean(upgradedValue) & "," & ¬
+				quote & "default_folder_id" & quote & ":" & my nullable_json_string(defaultFolderId) & "}"
+		end repeat
+	end tell
+	return "{" & quote & "items" & quote & ":[" & my join_list(jsonItems, ",") & "]}"
+end run
+
+on safe_text(valueText)
+	try
+		return valueText as text
+	on error
+		return ""
+	end try
+end safe_text
+
+on nullable_json_string(valueText)
+	if valueText is "" then
+		return "null"
+	end if
+	return my json_string(valueText)
+end nullable_json_string
+
+on json_boolean(boolValue)
+	if boolValue then
+		return "true"
+	end if
+	return "false"
+end json_boolean
+
+on json_string(valueText)
+	set backslash to ASCII character 92
+	set escapedText to my replace_text(valueText as text, backslash, backslash & backslash)
+	set escapedText to my replace_text(escapedText, quote, backslash & quote)
+	set escapedText to my replace_text(escapedText, return, backslash & "n")
+	set escapedText to my replace_text(escapedText, linefeed, backslash & "n")
+	return quote & escapedText & quote
+end json_string
+
+on replace_text(sourceText, findText, replaceText)
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to findText
+	set sourceItems to text items of sourceText
+	set AppleScript's text item delimiters to replaceText
+	set resultText to sourceItems as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return resultText
+end replace_text
+
+on join_list(itemList, delimiterText)
+	if (count of itemList) is 0 then
+		return ""
+	end if
+	set originalDelimiters to AppleScript's text item delimiters
+	set AppleScript's text item delimiters to delimiterText
+	set joinedText to itemList as text
+	set AppleScript's text item delimiters to originalDelimiters
+	return joinedText
+end join_list