NotesY

Access and manage Apple Notes on macOS via AppleScript.

GitHub

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

  1. Clone and build the project:
git clone https://github.com/yourusername/NotesY.git
cd NotesY
npm install
npm run build
  1. 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.

Serveurs connexes