Notes MCP

A Claude MCP integration that allows seamless interaction with Apple Notes through natural language.

Features

• Create notes with content and titles
• Update existing notes with new content
• Delete notes by title
• Search for notes containing specific text
• Automatically detect trip planning requests and create notes

Installation

1. Clone and build the project:

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

2. Add to Claude s configuration (usually at ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Usage

With Claude Desktop

Simply talk to Claude Desktop and ask it to:

Create a note titled  shopping list  with items: milk, eggs, bread

Add meeting notes to my  work  note

Delete my  old tasks  note

Search for notes with  project 

You can also just give Claude long text and it will create a note with appropriate title:

Create a comprehensive trip plan for Krabi, Thailand, including recommended duration, best time to visit, must-see attractions, accommodation options, transportation tips, food recommendations, and budget considerations.

Using the CLI

For testing without Claude, you can use the built-in CLI:

npm run cli

This lets you enter natural language commands directly and see the results.

Local Development

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

To run the Express server for API testing:

START_EXPRESS_SERVER=true npm run dev

How it Works

NotesY uses AppleScript to interact with the macOS Notes app, providing natural language understanding through an MCP integration with Claude Desktop.