NotesY is an MCP server that connects Claude and other Model Context Protocol clients directly to the native Apple Notes application on macOS. Designed for Mac users and developers seeking automated note management, NotesY operates by executing AppleScript commands behind the scenes to bridge local desktop interactions with large language models. Through standard natural language prompts, users can command their AI assistant to create new entries with custom titles and bodies, search existing notes using specific keyword matches, append text or meeting summaries to existing documents, and permanently remove outdated notes by title. It also features built-in handling to detect long-form content generation tasks, such as itinerary or trip planning, and convert the output directly into structured notes on the local device. Because it relies entirely on local macOS AppleScript routines, the server handles personal notes without requiring external third-party cloud note-taking APIs, allowing users to keep their Apple Notes workflow organized from their desktop AI interface.
Category: Files, Documents & PDFs
Tags: apple-notes, applescript, macos, notes
Follow these steps to set up NotesY with Claude Desktop: 1. Clone the project repository and navigate into the project directory: bash git clone https://github.com/yourusername/NotesY.git cd NotesY 2. Install the dependencies and build the server: bash npm install npm run build 3. Open Claude Desktop's configuration file (located at ~/Library/Application Support/Claude/claude_desktop_config.json) and add NotesY to the mcpServers object: json { "mcpServers": { "NotesY": { "command": "node", "args": ["/absolute/path/to/NotesY/dist/index.js"] } } } Replace /absolute/path/to/NotesY with the full path to your built directory, then restart Claude Desktop.
Part of MCP Servers
You install NotesY by cloning the GitHub repository, running npm install, and compiling the project using npm run build. Afterwards, you register the compiled dist/index.js file within your Claude Desktop configuration file under the mcpServers key, specifying node as the executable command.
NotesY enables Model Context Protocol clients to manage Apple Notes on macOS. It allows you to create new titled notes, append content to existing documents, delete notes by title, and search your note database for specific text phrases through conversational prompts.
NotesY requires macOS because it relies on AppleScript to interact directly with the native Apple Notes application. It cannot be used on Windows or Linux systems that do not have the Apple Notes desktop app or AppleScript support.
NotesY is built for Claude Desktop using its native Model Context Protocol configuration. Additionally, it includes a built-in command-line interface that allows you to test natural language commands and actions locally in your terminal without opening an external client.