PyPI - apple-mcp-notes - Versions diffs - 1.0.1__tar.gz - Mend

apple-mcp-notes 1.0.1__tar.gz

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.

Files changed (33) hide show

apple_mcp_notes-1.0.1/LICENSE ADDED Viewed

@@ -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/PKG-INFO ADDED Viewed

@@ -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/README.md ADDED Viewed

@@ -0,0 +1,116 @@
+<!-- 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/pyproject.toml ADDED Viewed

@@ -0,0 +1,61 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "apple-mcp-notes"
+version = "1.0.1"
+description = "Local Apple Notes MCP server for macOS"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+keywords = ["mcp", "model-context-protocol", "macos", "apple", "ai-agent", "automation"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Environment :: MacOS X",
+  "Intended Audience :: Developers",
+  "Operating System :: MacOS",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "apple-mcp-common>=1.0.0,<2",
+  "mcp>=2.0.0,<3",
+  "pydantic>=2.12.0",
+]
+[project.urls]
+Homepage = "https://github.com/JonathanRReed/Apple-MCPs"
+Repository = "https://github.com/JonathanRReed/Apple-MCPs"
+Changelog = "https://github.com/JonathanRReed/Apple-MCPs/blob/main/CHANGELOG.md"
+Issues = "https://github.com/JonathanRReed/Apple-MCPs/issues"
+[project.scripts]
+apple-notes-mcp = "apple_notes_mcp.tools:main"
+apple-mcp-notes = "apple_notes_mcp.tools:main"
+[project.optional-dependencies]
+dev = [
+  "pytest>=8,<10",
+  "ruff>=0.12,<1",
+]
+[tool.setuptools]
+package-dir = {"" = "src"}
+[tool.setuptools.package-data]
+apple_notes_mcp = ["applescripts/*.applescript"]
+[tool.setuptools.packages.find]
+where = ["src"]
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+[tool.uv.sources]
+apple-mcp-common = { workspace = true }

apple_mcp_notes-1.0.1/setup.cfg ADDED Viewed

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build =
+tag_date = 0

apple_mcp_notes-1.0.1/src/apple_mcp_notes.egg-info/PKG-INFO ADDED Viewed

@@ -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/src/apple_mcp_notes.egg-info/SOURCES.txt ADDED Viewed

@@ -0,0 +1,31 @@
+LICENSE
+README.md
+pyproject.toml
+src/apple_mcp_notes.egg-info/PKG-INFO
+src/apple_mcp_notes.egg-info/SOURCES.txt
+src/apple_mcp_notes.egg-info/dependency_links.txt
+src/apple_mcp_notes.egg-info/entry_points.txt
+src/apple_mcp_notes.egg-info/requires.txt
+src/apple_mcp_notes.egg-info/top_level.txt
+src/apple_notes_mcp/__init__.py
+src/apple_notes_mcp/config.py
+src/apple_notes_mcp/models.py
+src/apple_notes_mcp/notes_bridge.py
+src/apple_notes_mcp/permissions.py
+src/apple_notes_mcp/tools.py
+src/apple_notes_mcp/applescripts/create_folder.applescript
+src/apple_notes_mcp/applescripts/create_note.applescript
+src/apple_notes_mcp/applescripts/delete_folder.applescript
+src/apple_notes_mcp/applescripts/delete_note.applescript
+src/apple_notes_mcp/applescripts/get_note.applescript
+src/apple_notes_mcp/applescripts/list_accounts.applescript
+src/apple_notes_mcp/applescripts/list_attachments.applescript
+src/apple_notes_mcp/applescripts/list_folders.applescript
+src/apple_notes_mcp/applescripts/list_notes.applescript
+src/apple_notes_mcp/applescripts/move_note.applescript
+src/apple_notes_mcp/applescripts/rename_folder.applescript
+src/apple_notes_mcp/applescripts/update_note.applescript
+tests/test_bridge.py
+tests/test_config.py
+tests/test_permissions.py
+tests/test_tools.py

apple_mcp_notes-1.0.1/src/apple_mcp_notes.egg-info/dependency_links.txt ADDED Viewed

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

apple_mcp_notes-1.0.1/src/apple_mcp_notes.egg-info/entry_points.txt ADDED Viewed

@@ -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/src/apple_mcp_notes.egg-info/requires.txt ADDED Viewed

@@ -0,0 +1,7 @@
+apple-mcp-common<2,>=1.0.0
+mcp<3,>=2.0.0
+pydantic>=2.12.0
+[dev]
+pytest<10,>=8
+ruff<1,>=0.12

apple_mcp_notes-1.0.1/src/apple_mcp_notes.egg-info/top_level.txt ADDED Viewed

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

apple_mcp_notes-1.0.1/src/apple_notes_mcp/__init__.py ADDED Viewed

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

apple_mcp_notes-1.0.1/src/apple_notes_mcp/applescripts/create_folder.applescript ADDED Viewed

@@ -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