Loading ToolBench
MCP server for semantic search and RAG over Apple Notes
Apple Notes MCP has well-structured tool definitions with clear naming (verb_noun pattern), comprehensive descriptions (avg 150+ chars), and explicit Zod schemas for input validation. All 10 tools have descriptions and most parameters are typed. However, output schemas are not documented, LLMs cannot predict response structure. Error handling exists (custom error classes) but lacks recovery guidance. No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels. Parameter descriptions are good but some lack format/constraint details. Missing idempotency guarantees for write operations.
Append markdown content to an existing Apple Note. Identify note by noteId or current title.
Create a new Apple Note with a title and markdown content. Optionally place it in a folder path.
Delete an Apple Note (moves to Recently Deleted). Identify note by noteId or current title.
Edit an existing Apple Note's title and/or content. Identify note by noteId or current title.
Get a note's full content and details by noteId or title. Optionally scope by folder path. If the title is ambiguous, returns a list of matching candidates — retry with noteId or path to disambiguate.
Index all Apple Notes for semantic search. Run this first — takes seconds to minutes depending on note count.
Output schemas not documented. LLMs cannot predict response structure for any tool. Responses from list-notes, search-notes, get-note lack field definitions, forcing LLMs to guess at available fields for downstream chaining.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Tools are marked with Risk levels in metadata but not exposed via MCP tool annotations. Agents cannot distinguish safe reads from destructive writes without parsing descriptions.
Error messages lack recovery guidance. NoteNotFoundError and AmbiguousNoteError are raised but do not suggest next steps (e.g., 'Try search-notes() with a partial title' or 'Use list-folders to find the correct path').
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
List all Apple Notes folders with full paths and note counts
List Apple Notes with title, path, and timestamps. Optionally filter by folder path and include note content.
Move an Apple Note to a different folder. Identify note by noteId or current title.
Semantic and full-text search over notes. Optionally filter by folder path.
No idempotency guarantees documented for write operations. create-note, edit-note, append-to-note, move-note, delete-note do not state whether repeated calls with identical inputs are safe. Agents may retry on transient failures and cause duplicates.
Parameter descriptions lack format/constraint details. 'path' parameter accepts folder paths but does not specify format (e.g., 'iCloud/Work/Projects' vs 'iCloud > Work > Projects'). 'contentPreviewChars' lacks min/max bounds.