splitwise-mcp 3.3.1 → 3.4.1

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Splitwise — natural-language expense and group management via the Splitwise API",
-    "version": "3.3.1"
+    "version": "3.4.1"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Splitwise",
       "source": "./",
       "description": "MCP server for Splitwise — manage expenses, groups, and friends via natural language",
-      "version": "3.3.1",
+      "version": "3.4.1",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "splitwise-mcp",
   "displayName": "Splitwise",
-  "version": "3.3.1",
+  "version": "3.4.1",
   "description": "MCP server for Splitwise — natural-language expense and group management via the Splitwise API",
   "author": {
     "name": "Chris Hall",

package/.mcp.json

@@ -1,13 +1,15 @@
 {
   "mcpServers": {
     "splitwise": {
-      "command": "node",
+      "command": "npx",
       "args": [
-        "${CLAUDE_PLUGIN_ROOT}/dist/index.js"
+        "-y",
+        "splitwise-mcp"
       ],
       "env": {
         "SPLITWISE_API_KEY": "${SPLITWISE_API_KEY}",
-        "SPLITWISE_OUTPUT_DIR": "${SPLITWISE_OUTPUT_DIR}"
+        "SPLITWISE_OUTPUT_DIR": "${SPLITWISE_OUTPUT_DIR}",
+        "SPLITWISE_INPUT_DIR": "${SPLITWISE_INPUT_DIR}"
       }
     }
   }

package/README.md

@@ -21,6 +21,7 @@ Ask Claude things like:
 - *"Show me recent expenses"*
 - *"Delete that duplicate expense"*
 - *"Download the receipt from that hotel expense"*
+- *"Add that Amazon order screenshot as the receipt on the water-jug expense"*
 
 ## Requirements
 
@@ -114,6 +115,7 @@ Add to Claude Desktop config:
 |---------|----------|-------|
 | `SPLITWISE_API_KEY` | Yes | API key from [splitwise.com/apps/register](https://secure.splitwise.com/apps/register) |
 | `SPLITWISE_OUTPUT_DIR` | No | Where `sw_get_receipt` writes downloaded receipts (owner-only, mode 0600). Defaults to `~/Downloads/splitwise-mcp`, never the working directory. When set, a per-call `output_dir` must be inside it. |
+| `SPLITWISE_INPUT_DIR` | No | The only directory `receipt.path` may read from (`..` and symlinks out of it are refused). Unset — always the case on a hosted server — means receipts are accepted as `base64` only. |
 
 ## Confirmations
 
@@ -165,10 +167,11 @@ Every Splitwise write (creating, editing or deleting expenses, groups, friends,
 |------|-------------|
 | `sw_list_expenses` | List or search expenses with filters |
 | `sw_get_expense` | Full details of a single expense |
-| `sw_create_expense` | Create an expense (equal or custom split) |
-| `sw_update_expense` | Edit an existing expense |
+| `sw_create_expense` | Create an expense (equal or custom split), optionally with a receipt image/PDF |
+| `sw_update_expense` | Edit an existing expense, or attach/replace its receipt |
 | `sw_delete_expense` | Soft-delete an expense |
 | `sw_undelete_expense` | Restore a deleted expense |
+| `sw_attach_receipt` | Attach or replace the receipt on an existing expense, changing nothing else |
 | `sw_get_comments` | Get comments on an expense |
 | `sw_create_comment` | Add a comment to an expense |
 | `sw_delete_comment` | Delete a comment |
@@ -191,6 +194,8 @@ Every Splitwise write (creating, editing or deleting expenses, groups, friends,
 
 **"SPLITWISE_API_KEY is required"** -- set the environment variable in your MCP config or a `.env` file.
 
+**Attaching a receipt** -- `sw_create_expense`, `sw_update_expense` and `sw_attach_receipt` take `receipt: { base64, filename, mime_type? }` (works everywhere, including a hosted server) or, on a local server with `SPLITWISE_INPUT_DIR` set, `receipt: { path, filename }` for a file inside that directory. PNG, JPEG, GIF or PDF up to 10 MiB (Splitwise documents no limit); the type is detected from the bytes, and a `mime_type` that disagrees is refused. The confirmation preview shows the file's name, type, size and SHA-256 instead of its contents, and the token is bound to those bytes. After the write the tool checks Splitwise actually stored the file (`receipt.original`) and returns an error naming the expense if it did not. A receipt replaces any receipt already on the expense.
+
 **401 when opening a receipt URL** -- the `receipt.original` / `receipt.large` URLs on an expense are not public; they need the API key. Use `sw_get_receipt` instead of fetching them directly.
 
 **Receipt lands somewhere you can't read it** -- `sw_get_receipt` writes to the *server's* filesystem, which is not the caller's when the server is hosted or containerised. Pass `inline: true` for the bytes (an image block for images, an embedded resource for PDFs) or `extract_text: true` for a PDF's text. With `inline` or `extract_text` and no `output_dir`, nothing is written unless you also pass `write: true`. Pass `write: false` to skip the write in any case; if it fails on its own (read-only filesystem), the call still succeeds and reports `write_error` as long as you asked for content.