yazio-mcp 0.0.12 → 0.0.14

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 CHANGED
@@ -8,6 +8,8 @@ An MCP (Model Context Protocol) server that connects Claude/Cursor to your Yazio
8
8
 
9
9
  **Available on NPM**: `npx yazio-mcp`
10
10
 
11
+ **Claude Desktop Extension**: ~~[yazio-mcp.mcpb](https://github.com/fliptheweb/yazio-mcp/releases/latest/download/yazio-mcp.mcpb)~~ — one-click install is [broken upstream](https://github.com/modelcontextprotocol/mcpb/issues/281), see [workaround](#claude-desktop-extension).
12
+
11
13
  ## ✨ Features
12
14
 
13
15
  - 🔐 **Authentication** - Connect with your Yazio account
@@ -38,20 +40,30 @@ Add the following JSON your MCP client configuration:
38
40
  ```
39
41
 
40
42
 
41
- ### Claude Desktop
43
+ ### Claude Desktop (Extension)
44
+
45
+ > [!WARNING]
46
+ > One-click `.mcpb` install is broken by a Claude Desktop bug ([mcpb#281](https://github.com/modelcontextprotocol/mcpb/issues/281)). **Workaround:** download [yazio-mcp.zip](https://github.com/fliptheweb/yazio-mcp/releases/latest/download/yazio-mcp.zip), extract it, and use **Settings → Extensions → Advanced settings → Install Unpacked Extension**. Or just use the `npx` config above.
47
+
48
+ ### Claude Desktop (Manual)
42
49
 
43
50
  `~/Library/Application Support/Claude/claude_desktop_config.json`
44
51
 
45
52
  ### Claude Code (CLI)
46
53
 
47
- - Create a file named `.mcp.json` in a folder
48
- - Run `claude` in that folder
49
- - Approve access to the MCP when Claude runs for the first time in that folder
50
- - Optional: check configured MCP servers with `claude mcp list`
54
+ ```bash
55
+ claude mcp add yazio -e YAZIO_USERNAME=your_email@email.com -e YAZIO_PASSWORD=your_password -- npx -y yazio-mcp
56
+ ```
57
+
58
+ Verify with `claude mcp list`.
51
59
 
52
60
  ### Cursor
53
61
 
54
- Add JSON in your Cursor MCP configuration file (`~/.cursor/mcp.json`)
62
+ There are a few ways to add the server:
63
+
64
+ - **Settings UI** (easiest) — `Settings → MCP → + Add new MCP server`, then fill in the command, args, and env
65
+ - **Project config** — add JSON to `.cursor/mcp.json` in your project root
66
+ - **Global config** — add JSON to `~/.cursor/mcp.json` (applies to all projects)
55
67
 
56
68
 
57
69
  ## 💡 Use Cases