weneed-mcp 0.2.2 → 0.2.4
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 +32 -59
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,45 +1,46 @@
|
|
|
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
|
-
npm install -g weneed-mcp
|
|
27
|
-
```
|
|
24
|
+
You need a [WeNeed](https://app.weneed.ch) account (email/password) to use this.
|
|
28
25
|
|
|
29
|
-
|
|
26
|
+
### Claude Desktop (recommended)
|
|
30
27
|
|
|
31
|
-
|
|
28
|
+
1. Download [weneed-mcp.mcpb](https://github.com/lewpgs/weneed-mcp/releases/latest/download/weneed-mcp.mcpb)
|
|
29
|
+
2. Install it:
|
|
32
30
|
|
|
33
|
-
|
|
31
|
+
**macOS** - Double-click the file, or drag and drop it onto the Claude Desktop app icon
|
|
34
32
|
|
|
35
|
-
**
|
|
36
|
-
- **Double-click** the downloaded file, or
|
|
37
|
-
- **Drag and drop** it onto the Claude Desktop app icon
|
|
33
|
+
**Windows** - In Claude Desktop, go to File > Settings > Extensions > Advanced Settings > Install Extension and select the file
|
|
38
34
|
|
|
39
|
-
|
|
40
|
-
- In Claude Desktop, go to **File > Settings > Extensions > Advanced Settings > Install Extension** and select the downloaded file
|
|
35
|
+
3. Enter your WeNeed email and password when prompted. Your credentials are stored securely in your OS keychain.
|
|
41
36
|
|
|
42
|
-
|
|
37
|
+
That's it. You're ready to go.
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Advanced setup
|
|
42
|
+
|
|
43
|
+
These methods require [Node.js 18+](https://nodejs.org) installed on your machine.
|
|
43
44
|
|
|
44
45
|
### Claude Code
|
|
45
46
|
|
|
@@ -48,28 +49,12 @@ claude mcp add weneed -e WENEED_EMAIL=your-email@example.com \
|
|
|
48
49
|
-e WENEED_PASSWORD=your-password -- npx -y weneed-mcp
|
|
49
50
|
```
|
|
50
51
|
|
|
51
|
-
### Claude Desktop
|
|
52
|
-
|
|
53
|
-
Add to your `claude_desktop_config.json`:
|
|
54
|
-
|
|
55
|
-
```json
|
|
56
|
-
{
|
|
57
|
-
"mcpServers": {
|
|
58
|
-
"weneed": {
|
|
59
|
-
"command": "npx",
|
|
60
|
-
"args": ["-y", "weneed-mcp"],
|
|
61
|
-
"env": {
|
|
62
|
-
"WENEED_EMAIL": "your-email@example.com",
|
|
63
|
-
"WENEED_PASSWORD": "your-password"
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
```
|
|
52
|
+
### Claude Desktop (manual) / Cursor
|
|
69
53
|
|
|
70
|
-
|
|
54
|
+
Add the following to your config file:
|
|
71
55
|
|
|
72
|
-
|
|
56
|
+
- **Claude Desktop** - `claude_desktop_config.json`
|
|
57
|
+
- **Cursor** - `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global)
|
|
73
58
|
|
|
74
59
|
```json
|
|
75
60
|
{
|
|
@@ -86,7 +71,7 @@ Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
|
|
|
86
71
|
}
|
|
87
72
|
```
|
|
88
73
|
|
|
89
|
-
### Test
|
|
74
|
+
### Test connection
|
|
90
75
|
|
|
91
76
|
Verify your credentials work before wiring it into a client:
|
|
92
77
|
|
|
@@ -94,7 +79,7 @@ Verify your credentials work before wiring it into a client:
|
|
|
94
79
|
WENEED_EMAIL='your-email@example.com' WENEED_PASSWORD='your-password' npx weneed-mcp
|
|
95
80
|
```
|
|
96
81
|
|
|
97
|
-
## Available
|
|
82
|
+
## Available tools
|
|
98
83
|
|
|
99
84
|
| Tool | Description |
|
|
100
85
|
|---|---|
|
|
@@ -107,19 +92,7 @@ WENEED_EMAIL='your-email@example.com' WENEED_PASSWORD='your-password' npx weneed
|
|
|
107
92
|
| `search_catalog` | Search the Coop product catalog |
|
|
108
93
|
| `get_categories` | Get product categories from the Coop catalog |
|
|
109
94
|
|
|
110
|
-
##
|
|
111
|
-
|
|
112
|
-
Once configured, you can interact naturally:
|
|
113
|
-
|
|
114
|
-
- "What's on my shopping list?"
|
|
115
|
-
- "Add milk and eggs to my list"
|
|
116
|
-
- "Check off the bananas"
|
|
117
|
-
- "Search the catalog for gluten-free pasta"
|
|
118
|
-
- "Remove the yogurt from my list"
|
|
119
|
-
|
|
120
|
-
> **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.
|
|
121
|
-
|
|
122
|
-
## How It Works
|
|
95
|
+
## How it works
|
|
123
96
|
|
|
124
97
|
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.
|
|
125
98
|
|