feat: add create and delete note commands

- Add src/applescript.ts for AppleScript automation
- Add 'notes create' and 'notes delete' CLI commands
- Add create_note and delete_note MCP tools
- Add /notes:create and /notes:delete slash commands
- Update skill triggers for create/delete
- Update documentation

Author: cardmagic

CLAUDE.md

@@ -18,17 +18,18 @@ make clean          # Remove dist/ and node_modules/
 
 ## Architecture
 
-Dual-mode CLI/MCP tool for searching Apple Notes:
+Dual-mode CLI/MCP tool for searching and managing Apple Notes:
 
 ```
 src/
-├── index.ts      # Entry point - routes to CLI or MCP mode based on --mcp flag
-├── cli.ts        # Commander-based CLI (search, recent, folders, read commands)
-├── mcp.ts        # MCP server exposing tools via @modelcontextprotocol/sdk
-├── indexer.ts    # Builds search indexes from Apple Notes database
-├── searcher.ts   # Queries indexes with fuzzy matching via MiniSearch
-├── formatter.ts  # Terminal output formatting with chalk
-└── types.ts      # Shared types and Apple date conversion utilities
+├── index.ts       # Entry point - routes to CLI or MCP mode based on --mcp flag
+├── cli.ts         # Commander-based CLI (search, recent, folders, read, create, delete commands)
+├── mcp.ts         # MCP server exposing tools via @modelcontextprotocol/sdk
+├── applescript.ts # AppleScript automation for create/delete operations
+├── indexer.ts     # Builds search indexes from Apple Notes database
+├── searcher.ts    # Queries indexes with fuzzy matching via MiniSearch
+├── formatter.ts   # Terminal output formatting with chalk
+└── types.ts       # Shared types and Apple date conversion utilities
 ```
 
 **Data flow:**
@@ -57,7 +58,9 @@ commands/
 ├── recent.md            # /notes:recent slash command
 ├── folders.md           # /notes:folders slash command
 ├── folder.md            # /notes:folder slash command
-└── read.md              # /notes:read slash command
+├── read.md              # /notes:read slash command
+├── create.md            # /notes:create slash command
+└── delete.md            # /notes:delete slash command
 ```
 
 ## Releasing

README.md

@@ -6,22 +6,72 @@ CLI and MCP server to search and browse Apple Notes with fuzzy matching.
 
 - **Fuzzy search** - Find notes even with typos using MiniSearch
 - **Full-text search** - Searches note titles, snippets, and body content
+- **Create & delete notes** - Manage notes via AppleScript automation
 - **PDF text extraction** - Automatically extracts and indexes text from PDF attachments
 - **Folder browsing** - List and filter notes by folder
 - **Fast indexing** - SQLite FTS5 + MiniSearch for quick searches across thousands of notes
 - **Dual mode** - Use as CLI tool or MCP server for Claude Code integration
 
 ## Installation
 
+### Homebrew
+
+```bash
+brew install cardmagic/tap/notes
+```
+
+### npm
+
 ```bash
-# Install globally
 npm install -g @cardmagic/notes
+```
 
-# Or with pnpm
-pnpm add -g @cardmagic/notes
+### Claude Code Plugin (recommended)
+
+Install as a plugin to get skills (auto-invoked) and slash commands:
+
+```bash
+# Add the marketplace
+claude plugin marketplace add cardmagic/notes
+
+# Install the plugin
+claude plugin install notes@cardmagic
 ```
 
-### Requirements
+This gives you:
+- **Skill**: Claude automatically searches notes when you ask about notes
+- **Slash commands**: `/notes:search`, `/notes:recent`, `/notes:folders`, and more
+
+### MCP Server
+
+For direct MCP tool access without the plugin:
+
+```bash
+claude mcp add --transport stdio notes -- npx -y @cardmagic/notes --mcp
+```
+
+Or install globally first:
+
+```bash
+npm install -g @cardmagic/notes
+claude mcp add --transport stdio notes -- notes --mcp
+```
+
+### From source
+
+```bash
+git clone https://github.com/cardmagic/notes.git
+cd notes
+make install
+
+# Then add as plugin OR MCP server:
+claude plugin marketplace add cardmagic/notes
+claude plugin install notes@cardmagic
+# OR
+claude mcp add --transport stdio notes -- notes --mcp
+```
+
+## Requirements
 
 - **macOS** - Reads from Apple Notes database
 - **Full Disk Access** - Terminal/IDE needs access to `~/Library/Group Containers/`
@@ -32,6 +82,14 @@ pnpm add -g @cardmagic/notes
 brew install poppler
 ```
 
+## Granting Full Disk Access
+
+The tool needs to read your Notes database at `~/Library/Group Containers/group.com.apple.notes/`:
+
+1. Open **System Settings** > **Privacy & Security** > **Full Disk Access**
+2. Click **+** and add your terminal app (Terminal.app, iTerm, Warp, etc.)
+3. Restart your terminal
+
 ## CLI Usage
 
 ### Search notes
@@ -72,6 +130,26 @@ notes folder "Work" --limit 20
 notes read 12345
 ```
 
+### Create a note
+
+```bash
+# Create a new note in the default "Notes" folder
+notes create "Meeting Notes" --body "Agenda items for today..."
+
+# Create in a specific folder
+notes create "Shopping List" --body "Milk, eggs, bread" --folder "Personal"
+```
+
+### Delete a note
+
+```bash
+# Delete a note by title
+notes delete "Old Meeting Notes"
+
+# Delete from a specific folder (useful if multiple notes have the same title)
+notes delete "Draft" --folder "Work"
+```
+
 ### Manage index
 
 ```bash
@@ -91,6 +169,28 @@ The index uses **incremental updates** by default:
 - Detects and removes deleted notes
 - Much faster than full rebuild for small changes
 
+## Claude Code Plugin
+
+When installed as a plugin, you get:
+
+**Skill** (auto-invoked): Claude automatically searches notes when you ask things like:
+- "What's in my notes about recipes?"
+- "Find my notes about the project"
+- "Create a note about the meeting"
+- "Delete my draft notes"
+
+**Slash Commands**:
+
+| Command | Description |
+|---------|-------------|
+| `/notes:search <query>` | Fuzzy search with optional filters |
+| `/notes:recent` | Show recently modified notes |
+| `/notes:folders` | List all folders with note counts |
+| `/notes:folder "Name"` | List notes in a specific folder |
+| `/notes:read <id>` | Read full note content by ID |
+| `/notes:create <title>` | Create a new note |
+| `/notes:delete <title>` | Delete a note by title |
+
 ## MCP Server
 
 Run as an MCP server for Claude Code integration:
@@ -109,17 +209,19 @@ notes --mcp
 | `list_folders` | List all folders with note counts |
 | `notes_in_folder` | List notes in a specific folder |
 | `get_note_stats` | Get index statistics |
+| `create_note` | Create a new note |
+| `delete_note` | Delete a note by title |
 
-### Claude Code Configuration
+### Manual MCP Configuration
 
-Add to your MCP settings:
+For Claude Desktop or VS Code, add to your MCP configuration:
 
 ```json
 {
   "mcpServers": {
     "notes": {
-      "command": "notes",
-      "args": ["--mcp"]
+      "command": "npx",
+      "args": ["-y", "@cardmagic/notes", "--mcp"]
     }
   }
 }
@@ -187,6 +289,7 @@ src/
 ├── index.ts        # Entry point - routes to CLI or MCP
 ├── cli.ts          # Commander-based CLI
 ├── mcp.ts          # MCP server implementation
+├── applescript.ts  # AppleScript automation for create/delete
 ├── indexer.ts      # Builds search indexes from Notes database
 ├── searcher.ts     # Query engine with fuzzy matching
 ├── attachments.ts  # PDF text extraction
@@ -196,7 +299,7 @@ src/
 
 ## Privacy
 
-This tool only reads your local Notes database. No data is sent externally. The search index is stored locally in `~/.notes/`.
+This tool accesses your local Notes database for reading and uses AppleScript to create/delete notes. No data is sent externally. The search index is stored locally in `~/.notes/`.
 
 ## License
 

commands/create.md

@@ -0,0 +1,26 @@
+---
+description: Create a new Apple Note
+allowed-tools: Bash(notes:*)
+argument-hint: <title> --body "content" [--folder "Folder"]
+---
+
+# Create Note
+
+Create a new note in Apple Notes.
+
+## Instructions
+
+1. Check if the notes CLI is installed:
+```bash
+command -v notes || pnpm add -g @cardmagic/notes
+```
+
+2. Create the note:
+```bash
+notes create "$ARGUMENTS"
+```
+
+## Examples
+
+- `/notes:create "Meeting Notes" --body "Agenda items..."` - Create a note with content
+- `/notes:create "Shopping List" --body "Milk, Eggs" --folder "Personal"` - Create in specific folder

commands/delete.md

@@ -0,0 +1,26 @@
+---
+description: Delete an Apple Note by title
+allowed-tools: Bash(notes:*)
+argument-hint: <title> [--folder "Folder"]
+---
+
+# Delete Note
+
+Delete a note from Apple Notes by its title.
+
+## Instructions
+
+1. Check if the notes CLI is installed:
+```bash
+command -v notes || pnpm add -g @cardmagic/notes
+```
+
+2. Delete the note:
+```bash
+notes delete "$ARGUMENTS"
+```
+
+## Examples
+
+- `/notes:delete "Old Meeting Notes"` - Delete a note by title
+- `/notes:delete "Draft" --folder "Work"` - Delete from specific folder (useful if multiple notes have the same title)

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardmagic/notes",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "CLI and MCP server to search and browse Apple Notes",
   "author": {
     "name": "Lucas Carlson"

server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/cardmagic/notes",
     "source": "github"
   },
-  "version": "1.0.0",
+  "version": "1.1.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@cardmagic/notes",
-      "version": "1.0.0",
+      "version": "1.1.0",
       "transport": {
         "type": "stdio"
       }

skills/notes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: notes
-description: Search and browse Apple Notes. Use when user asks about notes, wants to find something in notes, or list their notes.
+description: Search, browse, create, and delete Apple Notes. Use when user asks about notes, wants to find something in notes, create a new note, or delete notes.
 triggers:
   - "notes"
   - "apple notes"
@@ -9,11 +9,16 @@ triggers:
   - "my notes"
   - "list notes"
   - "read note"
+  - "create note"
+  - "add note"
+  - "new note"
+  - "delete note"
+  - "remove note"
 ---
 
 # Apple Notes Skill
 
-Search and browse Apple Notes with fuzzy matching.
+Search, browse, create, and delete Apple Notes with fuzzy matching.
 
 ## Prerequisites
 
@@ -62,9 +67,21 @@ notes stats
 notes index [-f|--force]
 ```
 
+### Create a note
+```bash
+notes create "Title" --body "Content" [--folder "Folder"]
+```
+
+### Delete a note
+```bash
+notes delete "Title" [--folder "Folder"]
+```
+
 ## Examples
 
 - Search for "recipe": `notes search "recipe"`
 - Recent notes: `notes recent`
 - Notes in Taxes folder: `notes folder Taxes`
 - Read note ID 123: `notes read 123`
+- Create a note: `notes create "Meeting Notes" --body "Agenda items..."`
+- Delete a note: `notes delete "Old Draft"`