@squirrelnotes.app/mcp 2.5.0-test.369 → 2.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -20
- package/dist/stdio-handler.js +4162 -20064
- package/package.json +2 -4
package/README.md
CHANGED
|
@@ -397,15 +397,7 @@ Claude generates content
|
|
|
397
397
|
|
|
398
398
|
### Claude Desktop configuration
|
|
399
399
|
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
```sh
|
|
403
|
-
mkdir -m 700 ~/SquirrelUploads # or, if it already exists: chmod 700 ~/SquirrelUploads
|
|
404
|
-
```
|
|
405
|
-
|
|
406
|
-
On Windows, just create `SquirrelUploads` in your user folder. Whenever the Squirrel MCP server starts with local file access and the default root, it also creates an empty `~/SquirrelUploads` (0700) if it is missing (Gareth, 2026-10-30: "Create at start"), so the folder appears in your home folder and exists from the second start even if this step is skipped.
|
|
407
|
-
|
|
408
|
-
Then add both servers to `claude_desktop_config.json`:
|
|
400
|
+
Add both servers to `claude_desktop_config.json`:
|
|
409
401
|
|
|
410
402
|
```json
|
|
411
403
|
{
|
|
@@ -416,45 +408,46 @@ Then add both servers to `claude_desktop_config.json`:
|
|
|
416
408
|
"env": {
|
|
417
409
|
"SQUIRREL_API_BASE_URL": "https://api.squirrelnotes.app",
|
|
418
410
|
"SQUIRREL_API_KEY": "sqn_your_api_key",
|
|
419
|
-
"SQUIRREL_PASSPHRASE": "your-passphrase"
|
|
411
|
+
"SQUIRREL_PASSPHRASE": "your-passphrase",
|
|
412
|
+
"SQUIRREL_UPLOAD_ROOT": "/tmp"
|
|
420
413
|
}
|
|
421
414
|
},
|
|
422
415
|
"filesystem": {
|
|
423
416
|
"command": "npx",
|
|
424
|
-
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/
|
|
417
|
+
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
|
|
425
418
|
"env": {}
|
|
426
419
|
}
|
|
427
420
|
}
|
|
428
421
|
}
|
|
429
422
|
```
|
|
430
423
|
|
|
431
|
-
> **`SQUIRREL_UPLOAD_ROOT`** restricts which directories `upload_attachment_from_path` may read from.
|
|
424
|
+
> **`SQUIRREL_UPLOAD_ROOT`** restricts which directories `upload_attachment_from_path` may read from. Defaults to `os.tmpdir()` — `/tmp` on macOS/Linux, `%TEMP%` equivalent on Windows. Set to a comma-separated list for multiple allowed roots (e.g. `"/tmp,/Users/you/Downloads"`). This is a security guardrail — without it, a prompt-injection attack could trick Claude into uploading files from anywhere on disk (e.g. `~/.ssh/id_rsa`). Note: symlinks inside an allowed root that point outside it are not followed during the check — use OS-level controls if that is a concern.
|
|
432
425
|
|
|
433
426
|
### Example workflows
|
|
434
427
|
|
|
435
428
|
**Attach a Claude-generated CSV report to a note:**
|
|
436
429
|
> "Create a monthly expense summary as a CSV and attach it to my Finances note."
|
|
437
430
|
|
|
438
|
-
1. Claude generates the CSV content → `write_file("/
|
|
439
|
-
2. Claude calls `upload_attachment_from_path` with `localPath="/
|
|
431
|
+
1. Claude generates the CSV content → `write_file("/tmp/expenses.csv", content)` (Filesystem MCP)
|
|
432
|
+
2. Claude calls `upload_attachment_from_path` with `localPath="/tmp/expenses.csv"` (Squirrel MCP)
|
|
440
433
|
|
|
441
434
|
**Attach an xlsx file generated by a script:**
|
|
442
435
|
> "Write a Python script to generate an xlsx report and attach it to my Analytics note."
|
|
443
436
|
|
|
444
|
-
1. Claude writes the script to `/
|
|
445
|
-
2. Claude calls `upload_attachment_from_path` with `localPath="/
|
|
437
|
+
1. Claude writes the script to `/tmp/generate_report.py` → executes it → `report.xlsx` is written to `/tmp/`
|
|
438
|
+
2. Claude calls `upload_attachment_from_path` with `localPath="/tmp/report.xlsx"`
|
|
446
439
|
|
|
447
440
|
**Bulk-import Markdown files from disk:**
|
|
448
|
-
> "Import all the markdown files from
|
|
441
|
+
> "Import all the markdown files from /tmp/obsidian-export/ as notes in my Archive collection."
|
|
449
442
|
|
|
450
|
-
1. Claude calls `list_directory("/
|
|
443
|
+
1. Claude calls `list_directory("/tmp/obsidian-export/")` (Filesystem MCP) to enumerate files
|
|
451
444
|
2. For each `.md` file: `read_file(path)` → `create_note` with the content (Squirrel MCP)
|
|
452
445
|
|
|
453
446
|
**Export a note to disk:**
|
|
454
|
-
> "Export my project roadmap note as a Markdown file to
|
|
447
|
+
> "Export my project roadmap note as a Markdown file to /tmp/roadmap.md."
|
|
455
448
|
|
|
456
449
|
1. Claude calls `get_note(id)` (Squirrel MCP) to read the note
|
|
457
|
-
2. Claude calls `write_file("/
|
|
450
|
+
2. Claude calls `write_file("/tmp/roadmap.md", content)` (Filesystem MCP)
|
|
458
451
|
|
|
459
452
|
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.
|
|
460
453
|
|