weneed-mcp 0.1.0 → 0.1.1

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.
Files changed (2) hide show
  1. package/README.md +46 -15
  2. package/package.json +9 -2
package/README.md CHANGED
@@ -4,23 +4,26 @@ MCP server for [WeNeed](https://app.weneed.ch) - the Coop Switzerland shopping l
4
4
 
5
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.).
6
6
 
7
- > **Disclaimer**: This is an unofficial MCP server. WeNeed/Coop does not provide a public API. This project reverse-engineers the app's Firebase backend and may stop working at any time if they change their infrastructure.
7
+ > **Important**
8
+ > 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, security rules, or Cloud Functions.
10
+ > **Use at your own risk.**
8
11
 
9
12
  ## Prerequisites
10
13
 
11
14
  - Node.js 18+
12
15
  - A [WeNeed](https://app.weneed.ch) account (email/password login)
13
16
 
14
- ## Install
17
+ ## Quick Start
15
18
 
16
19
  ```bash
17
- npm install -g weneed-mcp
20
+ npx weneed-mcp
18
21
  ```
19
22
 
20
- Or run directly with `npx`:
23
+ Or install globally:
21
24
 
22
25
  ```bash
23
- npx weneed-mcp
26
+ npm install -g weneed-mcp
24
27
  ```
25
28
 
26
29
  ## Configuration
@@ -28,10 +31,13 @@ npx weneed-mcp
28
31
  ### Claude Code
29
32
 
30
33
  ```bash
31
- claude mcp add weneed -- npx -y weneed-mcp
34
+ claude mcp add weneed -e WENEED_EMAIL=your-email@example.com \
35
+ -e WENEED_PASSWORD=your-password -- npx -y weneed-mcp
32
36
  ```
33
37
 
34
- Then set your credentials as environment variables, or add them to the MCP config:
38
+ ### Claude Desktop
39
+
40
+ Add to your `claude_desktop_config.json`:
35
41
 
36
42
  ```json
37
43
  {
@@ -48,9 +54,9 @@ Then set your credentials as environment variables, or add them to the MCP confi
48
54
  }
49
55
  ```
50
56
 
51
- ### Claude Desktop
57
+ ### Cursor
52
58
 
53
- Add to your `claude_desktop_config.json`:
59
+ Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
54
60
 
55
61
  ```json
56
62
  {
@@ -67,14 +73,12 @@ Add to your `claude_desktop_config.json`:
67
73
  }
68
74
  ```
69
75
 
70
- ### From source
76
+ ### Test Connection
77
+
78
+ Verify your credentials work before wiring it into a client:
71
79
 
72
80
  ```bash
73
- git clone https://github.com/lewpgs/weneed-mcp.git
74
- cd weneed-mcp
75
- npm install
76
- npm run build
77
- node dist/index.js
81
+ WENEED_EMAIL='your-email@example.com' WENEED_PASSWORD='your-password' npx weneed-mcp
78
82
  ```
79
83
 
80
84
  ## Available Tools
@@ -100,12 +104,39 @@ Once configured, you can interact naturally:
100
104
  - "Search the catalog for gluten-free pasta"
101
105
  - "Remove the yogurt from my list"
102
106
 
107
+ > **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.
108
+
103
109
  ## How It Works
104
110
 
105
111
  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.
106
112
 
107
113
  Your credentials are only sent to Firebase/Google's authentication servers. They are never stored or transmitted anywhere else.
108
114
 
115
+ ## Development
116
+
117
+ ```bash
118
+ git clone https://github.com/lewpgs/weneed-mcp.git
119
+ cd weneed-mcp
120
+ npm install
121
+ npm run build
122
+ node dist/index.js
123
+ ```
124
+
125
+ Debug with the MCP Inspector:
126
+
127
+ ```bash
128
+ WENEED_EMAIL='your-email@example.com' WENEED_PASSWORD='your-password' \
129
+ npx -y @modelcontextprotocol/inspector npx weneed-mcp
130
+ ```
131
+
132
+ ## Disclaimers
133
+
134
+ - **Unofficial** - This project is not affiliated with, endorsed by, or connected to Coop or WeNeed in any way.
135
+ - **Reverse-engineered API** - This server interacts with WeNeed's Firebase backend, which is not a public API. Changes to Coop's Firebase project, Firestore security rules, or Cloud Functions could break this server without notice.
136
+ - **Credentials** - Your email and password are only used to authenticate with Firebase/Google. They are never stored or sent anywhere else.
137
+ - **Shared lists** - If you use shared shopping lists, actions taken through this MCP server (adding, checking, removing items) will be visible to all participants.
138
+ - **Use at your own risk** - No guarantees of functionality, availability, or compatibility.
139
+
109
140
  ## License
110
141
 
111
142
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "weneed-mcp",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "MCP server for WeNeed (Coop Switzerland) shopping lists",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -25,7 +25,14 @@
25
25
  "url": "https://github.com/lewpgs/weneed-mcp/issues"
26
26
  },
27
27
  "author": "lewpgs",
28
- "keywords": ["mcp", "weneed", "coop", "shopping-list", "firebase", "model-context-protocol"],
28
+ "keywords": [
29
+ "mcp",
30
+ "weneed",
31
+ "coop",
32
+ "shopping-list",
33
+ "firebase",
34
+ "model-context-protocol"
35
+ ],
29
36
  "license": "MIT",
30
37
  "dependencies": {
31
38
  "@modelcontextprotocol/sdk": "^1.12.1",