Server facts
apple-notes-mcp
Project
- Author
- ailenshen
- Repository
- github.com/ailenshen/apple-notes-mcp
- License
- MIT
- Category
- Productivity
Tech
- Runtime / language
- node
- Transports
- stdio
- Remote available
- No
- Authentication
- Not specified
Activity
- GitHub stars
- 12
- Last commit
- Data as of
Overview
Apple Notes workflows in this project cover finding existing material and writing formatted notes from an MCP client. Listings include titles, folders, dates, pinned status, and snippets, with optional folder filtering and result limits. Keyword searches match titles and snippets, while full-note retrieval returns Markdown. Reading by title can also include a folder to distinguish similarly named notes. For creation, the opening line supplies the title, and users can choose a destination folder. Notes.app’s Markdown importer turns supported formatting into native note styles, including headings, bold text, italics, lists, and inline code.
Updates replace the entire note by deleting the previous version and creating another in its original folder; paragraph-level edits are not supported. Deletion sends a note to Recently Deleted. Formatting has boundaries: block-quote text survives without indentation, links lose their URLs, and tables and footnotes are unsupported. The project requires macOS 26 or later and Node.js 24 or newer. Node needs Full Disk Access for database-backed listing and search, plus Accessibility permission to confirm the import dialog. Creating notes can briefly bring Notes.app to the foreground.
apple-notes-mcp setup notes
- apple-notes-mcp records stdio only; confirm a network transport upstream before planning remote access.