@mcp-z/mcp-sheets 2.3.0 → 2.3.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 +18 -11
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  MCP server for Google Sheets integration with OAuth authentication, spreadsheet management, batch operations, and advanced formatting
4
4
 
5
+ Requires Node.js >=20. The examples use `npx`, included with npm, to run this server and `@mcp-z/cli`.
6
+
5
7
  ## Common uses
6
8
 
7
9
  - Find spreadsheets and sheets
@@ -12,6 +14,11 @@ MCP server for Google Sheets integration with OAuth authentication, spreadsheet
12
14
 
13
15
  MCP supports stdio and HTTP.
14
16
 
17
+ Both the 2025 and 2026-07-28 protocol revisions are served, over either transport, from the same
18
+ server. Your client negotiates whichever it speaks. A 2025 client keeps working with no change,
19
+ and support for it is not being dropped. The 2026-07-28 revision is stateless, so a client speaking
20
+ it sends no `initialize` handshake and carries no session id.
21
+
15
22
  **Stdio**
16
23
  ```json
17
24
  {
@@ -40,7 +47,7 @@ MCP supports stdio and HTTP.
40
47
  }
41
48
  ```
42
49
 
43
- `start` is an extension used by `npx @mcp-z/cli up` to launch HTTP servers for you.
50
+ `start` is an extension used by `npx @mcp-z/cli up` to launch HTTP servers for you. The HTTP endpoint is `/mcp`.
44
51
 
45
52
  ## Create a Google Cloud app
46
53
 
@@ -49,10 +56,10 @@ MCP supports stdio and HTTP.
49
56
  3. Enable the Google Sheets API.
50
57
  4. Create OAuth 2.0 credentials (Desktop app).
51
58
  5. Copy the Client ID and Client Secret.
52
- 6. Select your MCP transport (stdio for local and http for remote) and platform
53
- - For stdio, choose "APIs & Services", + Create client, "Desktop app" type
54
- - For http, choose "APIs & Services", + Create client, "Web application" type, add your URL (default is http://localhost:3000/oauth/callback based on the --port or PORT)
55
- - For local hosting, add "http://127.0.0.1" for [Ephemeral redirect URL](https://en.wikipedia.org/wiki/Ephemeral_port)
59
+ 6. Select the credential type that matches your transport:
60
+ - For stdio, choose "Desktop app" under APIs & Services.
61
+ - For HTTP, choose "Web application" and add your public `/oauth/callback` URL. Local HTTP uses the port configured with `--port` or `PORT`.
62
+ - For local hosting, add `http://127.0.0.1` for the [ephemeral redirect URL](https://en.wikipedia.org/wiki/Ephemeral_port).
56
63
  7. Enable OAuth2 [scopes](https://console.cloud.google.com/auth/scopes): openid https://www.googleapis.com/auth/userinfo.profile https://www.googleapis.com/auth/userinfo.email https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive
57
64
  8. Add [test emails](https://console.cloud.google.com/auth/audience)
58
65
 
@@ -90,7 +97,7 @@ Example (http) - Create .mcp.json:
90
97
  "mcpServers": {
91
98
  "sheets": {
92
99
  "type": "http",
93
- "url": "http://localhost:3000",
100
+ "url": "http://localhost:3000/mcp",
94
101
  "start": {
95
102
  "command": "npx",
96
103
  "args": ["-y", "@mcp-z/mcp-sheets", "--port=3000"],
@@ -105,7 +112,7 @@ Example (http) - Create .mcp.json:
105
112
 
106
113
  Local (default): omit REDIRECT_URI → ephemeral loopback. Cloud: set REDIRECT_URI to your public /oauth/callback and expose the service publicly.
107
114
 
108
- Note: start block is a helper in "npx @mcp-z/cli up" for starting an http server from your .mpc.json. See [@mcp-z/cli](https://github.com/mcp-z/cli) for details.
115
+ Note: the `start` block is a helper in `npx @mcp-z/cli up` for starting an HTTP server from your `.mcp.json`. See [@mcp-z/cli](https://github.com/mcp-z/cli) for details.
109
116
 
110
117
  ### Service account
111
118
 
@@ -160,10 +167,10 @@ HTTP only. Requires a public base URL.
160
167
 
161
168
  ```bash
162
169
  # List tools
163
- mcp-z inspect --servers sheets --tools
170
+ npx -y @mcp-z/cli inspect --servers sheets --tools
164
171
 
165
172
  # Find a spreadsheet
166
- mcp-z call sheets spreadsheet-find '{"spreadsheetRef":"Quarterly Report"}'
173
+ npx -y @mcp-z/cli call-tool sheets spreadsheet-find '{"spreadsheetRef":"Quarterly Report"}'
167
174
  ```
168
175
 
169
176
  ## Tools
@@ -206,7 +213,7 @@ mcp-z call sheets spreadsheet-find '{"spreadsheetRef":"Quarterly Report"}'
206
213
 
207
214
  ## Configuration reference
208
215
 
209
- See `server.json` for all supported environment variables, CLI arguments, and defaults.
216
+ See [`server.json`](https://github.com/mcp-z/mcp-sheets/blob/master/server.json) for all supported environment variables, CLI arguments, and defaults.
210
217
 
211
218
  ## Storage backends
212
219
 
@@ -224,6 +231,6 @@ TOKEN_STORE_URI=redis://localhost:6379 mcp-sheets
224
231
 
225
232
  A protocol whose adapter is missing fails at startup naming the package to install.
226
233
 
227
- ### Documentation
234
+ ## Documentation
228
235
 
229
236
  [API Docs](https://mcp-z.github.io/mcp-sheets)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mcp-z/mcp-sheets",
3
- "version": "2.3.0",
3
+ "version": "2.3.1",
4
4
  "description": "MCP server for Google Sheets integration with OAuth authentication, spreadsheet management, batch operations, and advanced formatting",
5
5
  "keywords": [
6
6
  "sheets",
@@ -66,8 +66,8 @@
66
66
  "version": "tsds version"
67
67
  },
68
68
  "dependencies": {
69
- "@googleapis/drive": "^22.0.0",
70
- "@googleapis/sheets": "^14.0.0",
69
+ "@googleapis/drive": "^25.0.0",
70
+ "@googleapis/sheets": "^17.0.0",
71
71
  "@mcp-z/oauth": "^2.0.0",
72
72
  "@mcp-z/oauth-google": "^2.0.1",
73
73
  "@mcp-z/server": "^2.2.0",