apple-notes-mcp

Apple Notes MCP Server

Apple-notes-mcp connects AI clients to Apple Notes for browsing, keyword search, reading, creation, replacement, and deletion. It serves Mac users who want to work with their notes through AI while retaining native formatting when creating notes from Markdown.

Server facts

apple-notes-mcp

Project

Author
ailenshen
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.

Related MCP servers