splitwise-mcp 2.1.6 → 2.2.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": "2.1.6"
+    "version": "2.2.1"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Splitwise",
       "source": "./",
       "description": "MCP server for Splitwise — manage expenses, groups, and friends via natural language",
-      "version": "2.1.6",
+      "version": "2.2.1",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

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

package/.mcp.json

@@ -2,9 +2,12 @@
   "mcpServers": {
     "splitwise": {
       "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/index.js"],
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/dist/index.js"
+      ],
       "env": {
-        "SPLITWISE_API_KEY": "${SPLITWISE_API_KEY}"
+        "SPLITWISE_API_KEY": "${SPLITWISE_API_KEY}",
+        "SPLITWISE_OUTPUT_DIR": "${SPLITWISE_OUTPUT_DIR}"
       }
     }
   }

package/README.md

@@ -20,6 +20,7 @@ Ask Claude things like:
 - *"Add Meredith to the household group"*
 - *"Show me recent expenses"*
 - *"Delete that duplicate expense"*
+- *"Download the receipt from that hotel expense"*
 
 ## Requirements
 
@@ -112,10 +113,11 @@ Add to Claude Desktop config:
 | Env var | Required | Notes |
 |---------|----------|-------|
 | `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. Defaults to the current working directory. |
 
 ## Available tools
 
-20 tools across 5 domains. All tools are prefixed `sw_`.
+26 tools across 6 domains. All tools are prefixed `sw_`.
 
 ### User
 
@@ -123,6 +125,7 @@ Add to Claude Desktop config:
 |------|-------------|
 | `sw_get_current_user` | Get the authenticated user's profile |
 | `sw_get_user` | Get another user's profile by ID |
+| `sw_update_user` | Update the current user's profile fields |
 
 ### Groups
 
@@ -158,6 +161,12 @@ Add to Claude Desktop config:
 | `sw_create_comment` | Add a comment to an expense |
 | `sw_delete_comment` | Delete a comment |
 
+### Receipts
+
+| Tool | What it does |
+|------|-------------|
+| `sw_get_receipt` | Download an expense's receipt image/PDF with the server's credentials. Returns it inline (`inline`), as extracted PDF text (`extract_text`), and/or written to a file |
+
 ### Utilities
 
 | Tool | What it does |
@@ -170,6 +179,10 @@ Add to Claude Desktop config:
 
 **"SPLITWISE_API_KEY is required"** -- set the environment variable in your MCP config or a `.env` file.
 
+**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. Pass `write: false` to skip the write; if it fails on its own (read-only filesystem), the call still succeeds and reports `write_error` as long as you asked for content.
+
 **429 rate limit** -- Splitwise has undocumented rate limits. Wait a moment and retry.
 
 **Tools not appearing in Claude** -- go to **Claude Desktop > Settings > Developer** to see connected servers. Make sure you fully quit and relaunched after editing the config.
@@ -191,8 +204,9 @@ src/
     user.ts         sw_get_current_user, sw_get_user
     groups.ts       group CRUD and membership
     friends.ts      friend list and management
-    expenses.ts     expense CRUD, comments
-    utilities.ts    notifications, categories, currencies
+    expenses.ts     expense CRUD
+    receipts.ts     authenticated receipt download + PDF text extraction
+    utilities.ts    notifications, categories, currencies, comments
 ```
 
 ## License