NotesY - Apple Notes Integration for Claude

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

Clone and build the project:

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

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.