Notes

NotesY is an MCP server that lets you interact with Apple Notes through natural language. You can create, update, delete, and search notes, and the system can automatically detect trip planning requests to create notes. This makes managing notes hands-free and integrated with Claude via MCP.

How to use

You connect to NotesY through an MCP client. Once set up, you can speak or type natural language commands to manage your Apple Notes. Use simple commands to create notes with a title and content, add to existing notes, remove notes by title, or search for notes containing specific text. The system also recognizes trip-planning requests and creates a dedicated note with the plan.

Practical usage patterns you can try include creating a note with a clear title and content, updating an existing note by adding new information, deleting a note by its title, and searching for notes that contain particular terms. For example, you can say: Create a note titled 'shopping list' with content 'milk, eggs, bread', or Delete my 'old tasks' note, or Search for notes with 'project'.

If you ask Claude to draft a comprehensive plan, NotesY will generate a note that captures the full trip plan including duration, locations, accommodations, transportation tips, and budgeting considerations. Note that all interactions are performed through the MCP channel, so you can use the same workflow you use for other MCP-enabled tools.

How to install

Prerequisites you need before installing: Node.js and npm installed on macOS or your target environment.

git clone https://github.com/yourusername/NotesY.git
cd NotesY
npm install
npm run build

Additional setup and configuration

Configure NotesY as an MCP server by adding it to your Claude MCP client configuration. You will point to the local runtime that executes the NotesY MCP server.

{
  "mcpServers": {
    "NotesY": {
      "command": "node",
      "args": ["/absolute/path/to/NotesY/dist/index.js"]
    }
  }
}

Usage with Claude Desktop and CLI

With Claude Desktop you can speak commands like creating notes or deleting notes by title directly and Claude will route them to NotesY for execution.

For testing without Claude, you can use the built-in CLI to enter natural language commands and see results.

npm run cli

Local development and testing

If you want to run the Express server for API testing, start NotesY in development mode.

START_EXPRESS_SERVER=true npm run dev

Notes on how it works

NotesY uses macOS AppleScript to automate interactions with the Apple Notes app and exposes functionality through an MCP integration so you can control NotesY from Claude or other MCP clients.

Available tools

create_note

Create a new note with a title and content. Supports including initial content and a title.

update_note

Update an existing note by adding or replacing content for a specified title.

delete_note

Delete a note by its title.

search_notes

Search for notes containing specific text and return matching results.

trip_plan_detection

Automatically detect trip planning requests in natural language and create a corresponding note with planning details.