Apple Notes
PYPI · APPLE-MCP-NOTES · 2 COMPONENTS
Inspect, search, create, edit, move, and organize notes in Apple Notes on macOS.
Available components
Last scanned (23 hours ago)
Scores higher than 91% of PyPI servers
Category Productivity and Notes
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 1 of 29 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to JonathanRReed/Apple-MCPs). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 1 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability56
- 33% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Partial
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 786 tokens (~34/item across 23 items; 21 tools + 2 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management90
- Stability observed for 27 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage71
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 23 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 15 Oct 26 +38
- Injection markers: unverified → pass ▲ security
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → 33 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.87 ▲ functional
- 14 Oct 26 0
- Injection markers: unverified → pass ▲ security
- Stability: unverified → 0.83 ▲ functional
- Schema quality: unverified → 33 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Package version: 1.1.1 → 1.1.2 functional
- 13 Oct 26 0
- Package version: 1.0.5 → 1.1.1 functional
- Package version: 1.0.5 → 1.1.0 functional
- 12 Oct 26 −40
- Tool safety: pass → unverified ▼ security
- Stability: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Schema quality: 33 → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Package version: 1.0.5 → 1.1.0 functional
- 4 Oct 26 +1
- Stability: 0.97 → pass security
- 2 Oct 26 −1
- Stability: pass → 0.93 functional
- 1 Oct 26 +1
- Stability: 0.97 → pass security
- 29 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 16 Oct 2026 · Analysed pypi/apple-mcp-notes@1.1.2
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | JonathanRReed/Apple-MCPs |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/JonathanRReed/Apple-MCPs/.github/workflows/release.yml@refs/tags/v1.1.2 |
| Rekor log index | 3252401113 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:3522cad1d37ff057e3857e0581485013fcf58ceeb3e1676b55384ceea4529063 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | setuptools.build_meta |
Background: Why install scripts are a supply-chain risk →
Dependencies 29 packages
| Packages resolved | 29 |
|---|---|
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
get_tool_info Get Tool Info ~48
Load the full schema, examples, and metadata for one tool from this server.
| Name | Type | Req | Description |
|---|---|---|---|
| include_examples | boolean | – | – |
| include_schema | boolean | – | – |
| name | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
notes_append_to_note Append to Note ~55
Append text to an existing note without replacing its current content. Provide body_text for plain text or body_html for rich content.
| Name | Type | Req | Description |
|---|---|---|---|
| body_html | – | – | – |
| body_text | – | – | – |
| note_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_create_folder Create Folder ~45
Create a new folder in an Apple Notes account or nested folder.
| Name | Type | Req | Description |
|---|---|---|---|
| account_name | string | yes | – |
| folder_name | string | yes | – |
| parent_folder_id | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_create_note Create Note ~43
Create a new note in a folder.
| Name | Type | Req | Description |
|---|---|---|---|
| body_html | – | – | – |
| folder_id | string | yes | – |
| tags | – | – | – |
| title | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_delete_folder Delete Folder ~23
Delete an Apple Notes folder.
| Name | Type | Req | Description |
|---|---|---|---|
| folder_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_delete_note Delete Note ~24
Delete a note by note_id.
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_get_note Get Note ~29
Fetch full details for an Apple Notes note by note_id.
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_get_prompt Notes Get Prompt ~33
Fallback prompt rendering tool for tool-only MCP clients.
| Name | Type | Req | Description |
|---|---|---|---|
| arguments_json | – | – | – |
| name | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
notes_health Notes Health ~16
Report the active Apple Notes MCP configuration.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| capabilities | – | yes | – |
| ok | boolean | – | – |
| safety_mode | string | yes | – |
| server_name | string | yes | – |
| transport | string | – | – |
| version | string | yes | – |
No examples provided.
notes_list_accounts List Accounts ~14
List Apple Notes accounts.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_list_attachments List Attachments ~24
List attachments for a note.
| Name | Type | Req | Description |
|---|---|---|---|
| note_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_list_folders List Folders ~31
List Apple Notes folders.
| Name | Type | Req | Description |
|---|---|---|---|
| account_name | – | – | – |
| limit | – | – | – |
| offset | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_list_notes List Notes ~42
List notes, optionally scoped to a folder or account.
| Name | Type | Req | Description |
|---|---|---|---|
| account_name | – | – | – |
| folder_id | – | – | – |
| limit | – | – | – |
| offset | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_list_prompts Notes List Prompts ~21
Fallback prompt discovery tool for tool-only MCP clients.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
notes_move_note Move Note ~33
Move a note to a different folder.
| Name | Type | Req | Description |
|---|---|---|---|
| folder_id | string | yes | – |
| note_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_permission_guide Notes Permission Guide ~22
Explain how to grant Apple Notes automation permission on macOS.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
notes_recheck_permissions Notes Recheck Permissions ~31
Recheck Notes access after the user changes macOS permissions, and notify the client that Notes resources changed.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| capabilities | – | yes | – |
| ok | boolean | – | – |
| safety_mode | string | yes | – |
| server_name | string | yes | – |
| transport | string | – | – |
| version | string | yes | – |
No examples provided.
notes_rename_folder Rename Folder ~31
Rename an existing folder.
| Name | Type | Req | Description |
|---|---|---|---|
| folder_id | string | yes | – |
| folder_name | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_search_notes Search Notes ~48
Search notes by text, folder, or account.
| Name | Type | Req | Description |
|---|---|---|---|
| account_name | – | – | – |
| folder_id | – | – | – |
| limit | – | – | – |
| offset | – | – | – |
| query | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
notes_update_note Update Note ~44
Update an existing note.
| Name | Type | Req | Description |
|---|---|---|---|
| body_html | – | – | – |
| folder_id | – | – | – |
| note_id | string | yes | – |
| tags | – | – | – |
| title | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | – | yes | – |
No examples provided.
search_tools Search Tools ~50
Search this server's tool catalog by keyword, alias, or domain tag.
| Name | Type | Req | Description |
|---|---|---|---|
| domain_tags | – | – | – |
| limit | integer | – | – |
| mode | string | – | – |
| query | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
How do I install the Apple Notes MCP server?
Apple Notes runs locally as a PyPI package, launched with uvx apple-mcp-notes. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · apple-mcp-notes
claude mcp add jonathanrreed-apple-mcp-notes -- uvx apple-mcp-notes
What is the Apple Notes MCP server?
Apple Notes is an MCP server listed in the public MCP registry as io.github.JonathanRReed/apple-mcp-notes. Inspect, search, create, edit, move, and organize notes in Apple Notes on macOS. This page covers its PyPI package (apple-mcp-notes).
Is the Apple Notes MCP server safe to use?
Apple Notes scores 88 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 16 October 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Apple Notes MCP server expose?
Apple Notes exposes 21 tools: notes_health, notes_permission_guide, notes_recheck_permissions, notes_list_accounts, notes_list_folders, and 16 more. Their descriptions and schemas cost roughly 707 tokens of context every time the server is loaded.
Is the Apple Notes MCP server still maintained?
Apple Notes is still listed as active in the MCP registry. We last reached this channel on 16 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Apple Notes MCP server under?
Apple Notes declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.