README.md•1.94 kB
# 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:
```bash
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`):
```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:
```bash
npm run cli
```
This lets you enter natural language commands directly and see the results.
## Local Development
```bash
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:
```bash
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.