@squirrelnotes.app/mcp 1.27.3 → 1.28.0

package/README.md

@@ -96,8 +96,8 @@ Add both servers to `claude_desktop_config.json`:
 {
   "mcpServers": {
     "squirrel-notes": {
-      "command": "node",
-      "args": ["/path/to/squirrel-notes-mcp/dist/stdio-handler.js"],
+      "command": "npx",
+      "args": ["-y", "@squirrelnotes.app/mcp"],
       "env": {
         "SQUIRREL_API_BASE_URL": "https://api.squirrelnotes.app",
         "SQUIRREL_API_KEY": "sqn_your_api_key",
@@ -167,7 +167,41 @@ Neither header is ever stored, cached, or logged by the server.
 
 The stdio transport runs the MCP server as a local process on your machine. No OAuth, no network headers, no AWS account needed. Your passphrase is set as an env var in the config file and **never leaves your machine**.
 
-#### 1. Build the stdio handler
+#### Option A — npx (zero install, recommended)
+
+No download or build step required. `npx` fetches the latest published version automatically on first run and caches it locally.
+
+**1. Configure Claude Desktop**
+
+Open `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows) and add:
+
+```json
+{
+  "mcpServers": {
+    "squirrel-notes": {
+      "command": "npx",
+      "args": ["-y", "@squirrelnotes.app/mcp"],
+      "env": {
+        "SQUIRREL_API_BASE_URL": "https://api.squirrelnotes.app",
+        "SQUIRREL_API_KEY": "sqn_<your_api_key>",
+        "SQUIRREL_PASSPHRASE": "<your_passphrase>"
+      }
+    }
+  }
+}
+```
+
+**2. Restart Claude Desktop**
+
+Quit and reopen Claude Desktop. The Squirrel Notes MCP server will start automatically.
+
+**3. Verify**
+
+Ask Claude: *"List my Squirrel Notes"* — you should see your note titles.
+
+#### Option B — build from source (local development / pinned version)
+
+Use this if you want to run a specific local build or contribute to the server code.
 
 ```bash
 cd mcp
@@ -176,9 +210,7 @@ npm run build:stdio
 # Produces dist/stdio-handler.js
 ```
 
-#### 2. Configure Claude Desktop
-
-Open `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) and add:
+Then reference the built file directly:
 
 ```json
 {
@@ -196,15 +228,7 @@ Open `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) a
 }
 ```
 
-> **Windows:** Use `"command": "node"` and replace the path with `C:\\path\\to\\mcp\\dist\\stdio-handler.js` (double backslashes).
-
-#### 3. Restart Claude Desktop
-
-Quit and reopen Claude Desktop. The Squirrel Notes MCP server will start automatically.
-
-#### 4. Verify
-
-Ask Claude: *"List my Squirrel Notes"* — you should see your note titles.
+> **Windows:** Replace the path with `C:\\path\\to\\mcp\\dist\\stdio-handler.js` (double backslashes).
 
 ---
 
@@ -332,8 +356,8 @@ Set `SQUIRREL_LOG_FILE` to an absolute path in your `claude_desktop_config.json`
 {
   "mcpServers": {
     "squirrel-notes": {
-      "command": "node",
-      "args": ["/absolute/path/to/mcp/dist/stdio-handler.js"],
+      "command": "npx",
+      "args": ["-y", "@squirrelnotes.app/mcp"],
       "env": {
         "SQUIRREL_API_BASE_URL": "https://api.squirrelnotes.app",
         "SQUIRREL_API_KEY": "sqn_<your_api_key>",

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@squirrelnotes.app/mcp",
-  "version": "1.27.3",
-  "description": "MCP server Lambda for Squirrel Notes — bridges AI agents to the encrypted note-taking API",
+  "version": "1.28.0",
+  "description": "MCP stdio CLI for Squirrel Notes — bridges AI agents to the encrypted note-taking API",
   "type": "module",
   "bin": {
-    "squirrelnotes-app-mcp": "./dist/stdio-handler.js"
+    "squirrelnotes-app-mcp": "dist/stdio-handler.js"
   },
   "files": [
     "dist/stdio-handler.js",