{"id":"sweetrb-apple-notes-mcp","name":"apple-notes-mcp","homepage":null,"repo_url":"https://github.com/sweetrb/apple-notes-mcp","category":"communication","subcategories":[],"tags":["mcp","apple-notes","macos","applescript","typescript","productivity","automation","notes-management"],"what_it_does":"Provides an MCP server that lets AI assistants interact with Apple Notes on macOS via AppleScript/CoreData—creating, searching, reading, updating, deleting (move to Recently Deleted), moving notes between folders, and performing folder/account/batch/export/diagnostic operations. Uses local-only automation; no external APIs are described.","use_cases":["Save conversations as Apple Notes (create notes with titles/content)","Search notes by title or note body; filter by account/folder/date/limit","Read and summarize specific notes (HTML/Markdown export)","Update note titles/content reliably using note IDs (CoreData identifiers)","Organize notes by moving to folders; manage folders and accounts","Batch delete/move notes by IDs","Detect sync/shared state via diagnostics and warnings (per README features)"],"not_for":["Server-side/cloud note management (macOS Apple Notes automation is local and user-machine bound)","High-concurrency multi-user workflows (Apple Notes UI automation is typically single-user desktop behavior)","Use as a general document database (data model is Apple Notes/CoreData driven)","Handling secrets in note content without considering local access/security controls"],"best_when":"You want an AI assistant to manage your personal Apple Notes on your own Mac and you can grant macOS automation/AppleScript permissions.","avoid_when":"You cannot allow desktop automation of Notes.app, need guaranteed transactional safety for destructive operations, or require enterprise-grade audit/compliance guarantees beyond local device controls.","alternatives":["Using Apple Notes manually","Using third-party macOS automation tools that support Apple Notes (e.g., AppleScript-specific scripts)","Other MCP tools/integrations for note-taking services (e.g., Obsidian, Notion, Google Keep)"],"af_score":63.5,"security_score":56.2,"reliability_score":38.8,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:40:34.807607+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["TypeScript"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["macOS user consent for AppleScript automation (automation permission prompt)"],"oauth":false,"scopes":false,"notes":"No network authentication is described; access is effectively the local user’s ability to control Notes.app and the configured Notes accounts in Apple Notes."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"NPM package (MIT). No pricing model described for the server itself."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["local-to-user-machine (Apple Notes on macOS)"],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":63.5,"security_score":56.2,"reliability_score":38.8,"mcp_server_quality":80.0,"documentation_accuracy":78.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":85.0,"rate_limit_clarity":0.0,"tls_enforcement":100.0,"auth_strength":40.0,"scope_granularity":30.0,"dependency_hygiene":55.0,"secret_handling":60.0,"security_notes":"Strengths: local-only automation is implied; no external network API or tokens are described; TLS is not directly applicable because interactions are via local process/MCP over localhost. Concerns: any note content is accessible to whoever can use the MCP server; there is no mention of fine-grained authorization or per-tool scope enforcement; permission prompting for AppleScript automation means the user effectively grants powerful access to Notes.app.","uptime_documented":10.0,"version_stability":55.0,"breaking_changes_history":40.0,"error_recovery":50.0,"idempotency_support":"false","idempotency_notes":"Some operations are inherently non-idempotent (e.g., create-note). For update operations, idempotency depends on stable note IDs and content; move-note explicitly copies then deletes, which can cause duplicates if delete fails.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Use note IDs (CoreData identifiers) instead of titles to avoid duplicates/ambiguity.","Title/content rules: create-note expects title in `title` param and content without duplicating the title; plaintext/html formatting rules can lead to doubled titles if misunderstood.","move-note behavior: it copies to destination then deletes original; if delete fails the note may exist in both places.","Delete moves to Recently Deleted (recovery behavior depends on Notes app retention/UI).","Automation requires macOS permission to control Notes.app; the agent user must complete the prompt once."]}}