@squirrelnotes.app/mcp 2.1.1-test.344 → 2.1.1-test.346

package/README.md

@@ -31,7 +31,7 @@ The passphrase lives in `claude_desktop_config.json` on your machine and is pass
 | `get_note` | Returns a single note with decrypted title + full content. |
 | `create_note` | Creates a note with encrypted title + content. |
 | `update_note` | Updates title, content, or pinnedAt on a note. |
-| `delete_note` | Soft-deletes a note (recoverable). |
+| `delete_note` | Moves a note to trash (recoverable for 30 days). Its public share link is revoked at once. |
 | `pin_note` | Pins or unpins a note (appears at top of sidebar). |
 | `append_to_note` | Appends markdown content to an existing note. Saves the agent a get → update, but it is **not** race-free: it reads the note and writes it back whole, and the server has no version check, so an edit made elsewhere in between is overwritten. |
 | `set_note_tags` | Replaces all tags on a note. |
@@ -39,6 +39,45 @@ The passphrase lives in `claude_desktop_config.json` on your machine and is pass
 | `search_note_content` | Full-content search (slow — decrypts all notes). Use only when title search fails. |
 | `move_note_to_collection` | Moves a note to a collection (or to scratchpad if collectionId is null). |
 
+### Trash
+
+| Tool | Description |
+|------|-------------|
+| `list_trash` | Lists trashed notes with decrypted titles and when each was trashed. Trashed notes are hard-deleted automatically 30 days after trashing. |
+| `restore_note` | Restores a trashed note to its last collection. Public share links are not recreated. |
+| `permanently_delete_note` | Permanently deletes one trashed note, its attachments and its encrypted content. Irreversible; the note must already be in trash. |
+| `empty_trash` | Permanently deletes every trashed note and its attachments. Irreversible; requires `confirm: true`. |
+
+### Collections
+
+| Tool | Description |
+|------|-------------|
+| `list_collections` | Lists regular collections (folders) with decrypted names and `parentId` for nesting. Smart collections are left out: their notes are computed, so nothing can be placed in them. |
+| `get_collection` | Returns one collection with its decrypted name. |
+| `create_collection` | Creates a collection from a plaintext `name` (encrypted before the API call), optionally nested under `parentId`, with an optional `iconColor` hex code. |
+| `update_collection` | Changes a collection's name, parent or icon colour. Its kind cannot be changed. |
+| `delete_collection` | Deletes a collection. Its notes move to the scratchpad; they are not deleted. |
+
+### Tags
+
+| Tool | Description |
+|------|-------------|
+| `list_tags` | Lists tags with decrypted names and colours. Use it to find tag IDs for `set_note_tags`. |
+| `get_tag` | Returns one tag with its decrypted name. |
+| `create_tag` | Creates a tag from a plaintext `name` (encrypted before the API call) and an optional `color` hex code. |
+| `update_tag` | Changes a tag's name or colour. |
+| `delete_tag` | Deletes a tag and removes it from every note that had it. |
+
+### Sharing
+
+| Tool | Description |
+|------|-------------|
+| `share_note` | Publishes a note as a public link protected by a share passphrase, with optional `expiry` and `allowDownload` (default off). The note is decrypted here and re-encrypted under a key derived from the share passphrase, so the server never sees plaintext. Returns the share URL and token. The share passphrase is a tool argument, so it passes through your agent and its model provider; send it to recipients separately from the link. |
+| `get_share_status` | Returns a note's share URL, view count, expiry and settings, or `null` if it is not shared. |
+| `republish_share` | Re-encrypts an existing share with the note's latest content. Needs the share passphrase (the same one or a new one). |
+| `update_share_settings` | Changes a share's `expiry` and/or `allowDownload` without changing its content. |
+| `revoke_share` | Revokes a share link permanently; it stops working at once. The note is not affected. |
+
 ### Saved Searches (Pro)
 
 | Tool | Description |
@@ -209,7 +248,7 @@ Add both servers to `claude_desktop_config.json`:
 
 The server needs an API key and your passphrase, both set as env vars in your client's config (see Setup). The API key is sent to the Squirrel Notes API in the `Authorization` header; the passphrase is never sent anywhere.
 
-Generate an API key in Squirrel Notes → Settings → API Key (requires Pro tier).
+Generate an API key in Squirrel Notes → Settings → API & Data (requires Pro tier).
 
 ---
 
@@ -397,7 +436,7 @@ Not logged:
 | Variable | Required | Description |
 |----------|----------|-------------|
 | `SQUIRREL_API_BASE_URL` | ✅ | Base URL of the Squirrel Notes backend API (e.g. `https://api.squirrelnotes.app`) |
-| `SQUIRREL_API_KEY` | ✅ | Your API key from Settings → API Key (requires Pro tier) |
+| `SQUIRREL_API_KEY` | ✅ | Your API key from Settings → API & Data (requires Pro tier) |
 | `SQUIRREL_PASSPHRASE` | ✅ | Your encryption passphrase — never leaves your machine |
 | `SQUIRREL_LOG_FILE` | — | Absolute path to a log file. When set, all stderr output is also appended to this file. |
 | `SQUIRREL_MEMORY_EMBEDDINGS`, `SQUIRREL_MEMORY_MODEL_DIR`, `SQUIRREL_MEMORY_CACHE_DIR` | — | Read only by the opt-in embeddings companion (`@squirrelnotes.app/mcp-embeddings`); see its README. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squirrelnotes.app/mcp",
-  "version": "2.1.1-test.344",
+  "version": "2.1.1-test.346",
   "description": "MCP stdio CLI for Squirrel Notes — bridges AI agents to the encrypted note-taking API",
   "type": "module",
   "repository": {