@oliverames/ynab-mcp-server 1.2.3 → 1.3.0

package/README.md

@@ -10,9 +10,9 @@
 </p>
 
 <p align="center">
-  <code>43 tools</code> &bull;
+  <code>44 tools</code> &bull;
   <code>100% API coverage</code> &bull;
-  <code>YNAB API v1.79</code>
+  <code>YNAB API v1.82</code>
 </p>
 
 <p align="center">
@@ -121,14 +121,14 @@ That's it. Your AI can now talk to YNAB.
 
 ## Features
 
-**Complete YNAB API v1.79 coverage** with 43 tools:
+**Complete YNAB API v1.82 coverage** with 44 tools:
 
 | Resource | Tools | Capabilities |
 |----------|-------|-------------|
 | **Budgets** | 4 | List, view details, settings |
 | **Accounts** | 3 | List, view, create |
 | **Categories** | 9 | Full CRUD, groups, search, goals, monthly budgets |
-| **Payees** | 4 | List, view, rename, search |
+| **Payees** | 5 | List, view, create, rename, search |
 | **Payee Locations** | 3 | GPS coordinates for mobile transactions |
 | **Months** | 2 | Monthly summaries with per-category breakdown |
 | **Money Movements** | 4 | Budget re-allocation tracking |
@@ -191,6 +191,7 @@ That's it. Your AI can now talk to YNAB.
 |------|-------------|
 | `list_payees` | List all payees with transfer account mappings |
 | `get_payee` | Get payee details |
+| `create_payee` | Create a new payee |
 | `update_payee` | Rename a payee |
 | `search_payees` | Case-insensitive partial name search |
 
@@ -255,18 +256,31 @@ That's it. Your AI can now talk to YNAB.
 
 | Variable | Required | Description |
 |----------|----------|-------------|
-| `YNAB_API_TOKEN` | Yes | [Personal access token](https://app.ynab.com/settings/developer) from YNAB Developer Settings |
+| `YNAB_API_TOKEN` | Yes* | [Personal access token](https://app.ynab.com/settings/developer) from YNAB Developer Settings |
 | `YNAB_BUDGET_ID` | No | Default budget ID. If omitted, uses `"last-used"` (your most recently accessed budget). Run `list_budgets` to find IDs. |
+| `YNAB_OP_PATH` | No | 1Password secret reference for your API token (see below). Required only if using the 1Password fallback instead of `YNAB_API_TOKEN`. |
+
+*`YNAB_API_TOKEN` is required unless `YNAB_OP_PATH` is set.
 
 ### 1Password Integration
 
-If `YNAB_API_TOKEN` is not set in the environment, the server automatically attempts to resolve it from [1Password CLI](https://developer.1password.com/docs/cli/):
+If you store your YNAB token in [1Password CLI](https://developer.1password.com/docs/cli/), set `YNAB_OP_PATH` to your secret reference and omit `YNAB_API_TOKEN`:
 
-```
-op://Development/YNAB API Token/credential
+```json
+{
+  "mcpServers": {
+    "ynab": {
+      "command": "npx",
+      "args": ["-y", "@oliverames/ynab-mcp-server"],
+      "env": {
+        "YNAB_OP_PATH": "op://Personal/YNAB API Token/credential"
+      }
+    }
+  }
+}
 ```
 
-This means you can skip setting the env var entirely if you have `op` installed and a service account or session active. The fallback adds ~1-2s to startup and is silently skipped if 1Password is unavailable.
+The fallback adds ~1-2s to startup and is silently skipped if `op` is unavailable or the item is not found.
 
 ---