weneed-mcp 0.2.1 → 0.2.3
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 +44 -40
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,51 +1,59 @@
|
|
|
1
1
|
# weneed-mcp
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
Manage your shopping lists, add/remove items, and search the Coop product catalog through any MCP-compatible client (Claude Code, Claude Desktop, Cursor, etc.).
|
|
3
|
+
Manage your [WeNeed](https://app.weneed.ch) (Coop Switzerland) shopping lists with Claude. Add items, check them off, search the Coop catalog, and more.
|
|
6
4
|
|
|
7
5
|
> **Important**
|
|
8
6
|
> This is **not an official MCP server** and is **not affiliated with Coop or WeNeed** in any way.
|
|
9
|
-
> It uses a reverse-engineered Firebase backend and may **stop working at any time** if Coop changes their infrastructure
|
|
7
|
+
> It uses a reverse-engineered Firebase backend and may **stop working at any time** if Coop changes their infrastructure.
|
|
10
8
|
> **Use at your own risk.**
|
|
11
9
|
|
|
12
|
-
##
|
|
10
|
+
## What you can do
|
|
13
11
|
|
|
14
|
-
|
|
15
|
-
- A [WeNeed](https://app.weneed.ch) account (email/password login)
|
|
12
|
+
Once installed, just talk to Claude naturally:
|
|
16
13
|
|
|
17
|
-
|
|
14
|
+
- "What's on my shopping list?"
|
|
15
|
+
- "Add milk and eggs to my list"
|
|
16
|
+
- "Check off the bananas"
|
|
17
|
+
- "Search the catalog for gluten-free pasta"
|
|
18
|
+
- "Remove the yogurt from my list"
|
|
18
19
|
|
|
19
|
-
|
|
20
|
-
npx weneed-mcp
|
|
21
|
-
```
|
|
20
|
+
> **Note:** If you use shared lists, actions taken through this server will be visible to all participants.
|
|
22
21
|
|
|
23
|
-
|
|
22
|
+
## Install
|
|
24
23
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
24
|
+
You need a [WeNeed](https://app.weneed.ch) account (email/password) to use this.
|
|
25
|
+
|
|
26
|
+
### Claude Desktop (recommended)
|
|
27
|
+
|
|
28
|
+
1. Download [weneed-mcp.mcpb](https://github.com/lewpgs/weneed-mcp/releases/latest/download/weneed-mcp.mcpb)
|
|
29
|
+
2. Install it:
|
|
30
|
+
|
|
31
|
+
**macOS** - Double-click the file, or drag and drop it onto the Claude Desktop app icon
|
|
32
|
+
|
|
33
|
+
**Windows** - In Claude Desktop, go to File > Settings > Extensions > Advanced Settings > Install Extension and select the file
|
|
28
34
|
|
|
29
|
-
|
|
35
|
+
3. Enter your WeNeed email and password when prompted. Your credentials are stored securely in your OS keychain.
|
|
30
36
|
|
|
31
|
-
|
|
37
|
+
That's it. You're ready to go.
|
|
32
38
|
|
|
33
|
-
|
|
39
|
+
---
|
|
34
40
|
|
|
35
|
-
|
|
36
|
-
- **Drag and drop** onto the Claude Desktop app icon (macOS only)
|
|
37
|
-
- **Manual install** - File > Settings > Extensions > Advanced Settings > Install Extension
|
|
41
|
+
## Advanced setup
|
|
38
42
|
|
|
39
|
-
|
|
43
|
+
These methods require [Node.js 18+](https://nodejs.org) installed on your machine.
|
|
40
44
|
|
|
41
|
-
|
|
45
|
+
<details>
|
|
46
|
+
<summary><strong>Claude Code</strong></summary>
|
|
42
47
|
|
|
43
48
|
```bash
|
|
44
49
|
claude mcp add weneed -e WENEED_EMAIL=your-email@example.com \
|
|
45
50
|
-e WENEED_PASSWORD=your-password -- npx -y weneed-mcp
|
|
46
51
|
```
|
|
47
52
|
|
|
48
|
-
|
|
53
|
+
</details>
|
|
54
|
+
|
|
55
|
+
<details>
|
|
56
|
+
<summary><strong>Claude Desktop (manual config)</strong></summary>
|
|
49
57
|
|
|
50
58
|
Add to your `claude_desktop_config.json`:
|
|
51
59
|
|
|
@@ -64,7 +72,10 @@ Add to your `claude_desktop_config.json`:
|
|
|
64
72
|
}
|
|
65
73
|
```
|
|
66
74
|
|
|
67
|
-
|
|
75
|
+
</details>
|
|
76
|
+
|
|
77
|
+
<details>
|
|
78
|
+
<summary><strong>Cursor</strong></summary>
|
|
68
79
|
|
|
69
80
|
Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
|
|
70
81
|
|
|
@@ -83,7 +94,10 @@ Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
|
|
|
83
94
|
}
|
|
84
95
|
```
|
|
85
96
|
|
|
86
|
-
|
|
97
|
+
</details>
|
|
98
|
+
|
|
99
|
+
<details>
|
|
100
|
+
<summary><strong>Test connection</strong></summary>
|
|
87
101
|
|
|
88
102
|
Verify your credentials work before wiring it into a client:
|
|
89
103
|
|
|
@@ -91,7 +105,9 @@ Verify your credentials work before wiring it into a client:
|
|
|
91
105
|
WENEED_EMAIL='your-email@example.com' WENEED_PASSWORD='your-password' npx weneed-mcp
|
|
92
106
|
```
|
|
93
107
|
|
|
94
|
-
|
|
108
|
+
</details>
|
|
109
|
+
|
|
110
|
+
## Available tools
|
|
95
111
|
|
|
96
112
|
| Tool | Description |
|
|
97
113
|
|---|---|
|
|
@@ -104,19 +120,7 @@ WENEED_EMAIL='your-email@example.com' WENEED_PASSWORD='your-password' npx weneed
|
|
|
104
120
|
| `search_catalog` | Search the Coop product catalog |
|
|
105
121
|
| `get_categories` | Get product categories from the Coop catalog |
|
|
106
122
|
|
|
107
|
-
##
|
|
108
|
-
|
|
109
|
-
Once configured, you can interact naturally:
|
|
110
|
-
|
|
111
|
-
- "What's on my shopping list?"
|
|
112
|
-
- "Add milk and eggs to my list"
|
|
113
|
-
- "Check off the bananas"
|
|
114
|
-
- "Search the catalog for gluten-free pasta"
|
|
115
|
-
- "Remove the yogurt from my list"
|
|
116
|
-
|
|
117
|
-
> **Note:** If you use shared lists, this MCP server can modify items visible to all participants. Keep that in mind when adding, checking, or removing items.
|
|
118
|
-
|
|
119
|
-
## How It Works
|
|
123
|
+
## How it works
|
|
120
124
|
|
|
121
125
|
WeNeed is a Progressive Web App backed by Firebase (Firestore + Cloud Functions). This MCP server authenticates with your credentials using the Firebase JS SDK, then reads/writes directly to the same Firestore collections and calls the same Cloud Functions that the official app uses.
|
|
122
126
|
|