@n24q02m/workspace 0.6.0 → 0.7.0
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/NOTICE +9 -2
- package/README.md +108 -15
- package/bin/cli.mjs +78 -51
- package/build/src/auth/workspace-auth.test.js +3 -3
- package/build/src/auth/workspace-auth.test.js.map +1 -1
- package/build/src/cli/tools.d.ts +64 -0
- package/build/src/cli/tools.d.ts.map +1 -0
- package/build/src/cli/tools.integration.test.d.ts +2 -0
- package/build/src/cli/tools.integration.test.d.ts.map +1 -0
- package/build/src/cli/tools.integration.test.js +46 -0
- package/build/src/cli/tools.integration.test.js.map +1 -0
- package/build/src/cli/tools.js +411 -0
- package/build/src/cli/tools.js.map +1 -0
- package/build/src/cli/tools.test.d.ts +2 -0
- package/build/src/cli/tools.test.d.ts.map +1 -0
- package/build/src/cli/tools.test.js +365 -0
- package/build/src/cli/tools.test.js.map +1 -0
- package/build/src/constants.d.ts +2 -1
- package/build/src/constants.d.ts.map +1 -1
- package/build/src/constants.js +8 -5
- package/build/src/constants.js.map +1 -1
- package/build/src/data-dir-migration.d.ts +72 -0
- package/build/src/data-dir-migration.d.ts.map +1 -0
- package/build/src/data-dir-migration.js +181 -0
- package/build/src/data-dir-migration.js.map +1 -0
- package/build/src/data-dir-migration.test.d.ts +2 -0
- package/build/src/data-dir-migration.test.d.ts.map +1 -0
- package/build/src/data-dir-migration.test.js +148 -0
- package/build/src/data-dir-migration.test.js.map +1 -0
- package/build/src/data-dir.d.ts +59 -0
- package/build/src/data-dir.d.ts.map +1 -0
- package/build/src/data-dir.js +94 -0
- package/build/src/data-dir.js.map +1 -0
- package/build/src/data-dir.test.d.ts +2 -0
- package/build/src/data-dir.test.d.ts.map +1 -0
- package/build/src/data-dir.test.js +73 -0
- package/build/src/data-dir.test.js.map +1 -0
- package/build/src/docs/calendar.md +27 -0
- package/build/src/docs/chat.md +34 -0
- package/build/src/docs/config.md +17 -0
- package/build/src/docs/docs.md +1 -1
- package/build/src/docs/drive.md +29 -0
- package/build/src/docs/forms.md +19 -0
- package/build/src/docs/gmail.md +37 -0
- package/build/src/docs/overview.md +24 -0
- package/build/src/docs/people.md +23 -0
- package/build/src/docs/sheets.md +27 -0
- package/build/src/docs/slides.md +31 -0
- package/build/src/docs/tasks.md +18 -0
- package/build/src/main.d.ts +2 -0
- package/build/src/main.d.ts.map +1 -1
- package/build/src/main.js +25 -5
- package/build/src/main.js.map +1 -1
- package/build/src/main.test.js +42 -1
- package/build/src/main.test.js.map +1 -1
- package/build/src/tools/config.d.ts +10 -1
- package/build/src/tools/config.d.ts.map +1 -1
- package/build/src/tools/config.js +20 -1
- package/build/src/tools/config.js.map +1 -1
- package/build/src/tools/dispatch.d.ts +25 -0
- package/build/src/tools/dispatch.d.ts.map +1 -0
- package/build/src/tools/dispatch.js +119 -0
- package/build/src/tools/dispatch.js.map +1 -0
- package/build/src/tools/domains/bounds-e2e.test.d.ts +2 -0
- package/build/src/tools/domains/bounds-e2e.test.d.ts.map +1 -0
- package/build/src/tools/domains/bounds-e2e.test.js +166 -0
- package/build/src/tools/domains/bounds-e2e.test.js.map +1 -0
- package/build/src/tools/domains/bounds.d.ts +53 -0
- package/build/src/tools/domains/bounds.d.ts.map +1 -0
- package/build/src/tools/domains/bounds.js +72 -0
- package/build/src/tools/domains/bounds.js.map +1 -0
- package/build/src/tools/domains/calendar.d.ts.map +1 -1
- package/build/src/tools/domains/calendar.js +5 -1
- package/build/src/tools/domains/calendar.js.map +1 -1
- package/build/src/tools/domains/chat.d.ts.map +1 -1
- package/build/src/tools/domains/chat.js +3 -1
- package/build/src/tools/domains/chat.js.map +1 -1
- package/build/src/tools/domains/docs.d.ts.map +1 -1
- package/build/src/tools/domains/docs.js +2 -1
- package/build/src/tools/domains/docs.js.map +1 -1
- package/build/src/tools/domains/drive.d.ts.map +1 -1
- package/build/src/tools/domains/drive.js +5 -1
- package/build/src/tools/domains/drive.js.map +1 -1
- package/build/src/tools/domains/factory-bounds.test.d.ts +2 -0
- package/build/src/tools/domains/factory-bounds.test.d.ts.map +1 -0
- package/build/src/tools/domains/factory-bounds.test.js +169 -0
- package/build/src/tools/domains/factory-bounds.test.js.map +1 -0
- package/build/src/tools/domains/factory.d.ts +15 -0
- package/build/src/tools/domains/factory.d.ts.map +1 -1
- package/build/src/tools/domains/factory.js +18 -1
- package/build/src/tools/domains/factory.js.map +1 -1
- package/build/src/tools/domains/forms.d.ts.map +1 -1
- package/build/src/tools/domains/forms.js +5 -1
- package/build/src/tools/domains/forms.js.map +1 -1
- package/build/src/tools/domains/gmail.d.ts.map +1 -1
- package/build/src/tools/domains/gmail.js +5 -1
- package/build/src/tools/domains/gmail.js.map +1 -1
- package/build/src/tools/domains/index.d.ts.map +1 -1
- package/build/src/tools/domains/index.js +94 -12
- package/build/src/tools/domains/index.js.map +1 -1
- package/build/src/tools/domains/people.d.ts.map +1 -1
- package/build/src/tools/domains/people.js +2 -1
- package/build/src/tools/domains/people.js.map +1 -1
- package/build/src/tools/domains/slides.d.ts.map +1 -1
- package/build/src/tools/domains/slides.js +2 -1
- package/build/src/tools/domains/slides.js.map +1 -1
- package/build/src/tools/domains/tasks.d.ts.map +1 -1
- package/build/src/tools/domains/tasks.js +3 -1
- package/build/src/tools/domains/tasks.js.map +1 -1
- package/build/src/tools/helpers/bounds.d.ts +72 -0
- package/build/src/tools/helpers/bounds.d.ts.map +1 -0
- package/build/src/tools/helpers/bounds.js +234 -0
- package/build/src/tools/helpers/bounds.js.map +1 -0
- package/build/src/tools/helpers/bounds.test.d.ts +2 -0
- package/build/src/tools/helpers/bounds.test.d.ts.map +1 -0
- package/build/src/tools/helpers/bounds.test.js +239 -0
- package/build/src/tools/helpers/bounds.test.js.map +1 -0
- package/build/src/tools/registry.d.ts +28 -0
- package/build/src/tools/registry.d.ts.map +1 -1
- package/build/src/tools/registry.js +15 -120
- package/build/src/tools/registry.js.map +1 -1
- package/build/src/tools/registry.test.js +7 -1
- package/build/src/tools/registry.test.js.map +1 -1
- package/build/src/vendored/services/CalendarService.d.ts +2 -0
- package/build/src/vendored/services/CalendarService.d.ts.map +1 -1
- package/build/src/vendored/services/CalendarService.js +13 -2
- package/build/src/vendored/services/CalendarService.js.map +1 -1
- package/build/src/vendored/services/ChatService.d.ts +4 -1
- package/build/src/vendored/services/ChatService.d.ts.map +1 -1
- package/build/src/vendored/services/ChatService.js +11 -3
- package/build/src/vendored/services/ChatService.js.map +1 -1
- package/build/src/vendored/services/DocsService.d.ts.map +1 -1
- package/build/src/vendored/services/DocsService.js +6 -1
- package/build/src/vendored/services/DocsService.js.map +1 -1
- package/build/src/vendored/services/DocsService.test.js +2 -2
- package/build/src/vendored/services/DocsService.test.js.map +1 -1
- package/build/src/vendored/services/DriveService.d.ts +3 -1
- package/build/src/vendored/services/DriveService.d.ts.map +1 -1
- package/build/src/vendored/services/DriveService.js +10 -3
- package/build/src/vendored/services/DriveService.js.map +1 -1
- package/build/src/vendored/services/SheetsService.d.ts +6 -2
- package/build/src/vendored/services/SheetsService.d.ts.map +1 -1
- package/build/src/vendored/services/SheetsService.js +67 -6
- package/build/src/vendored/services/SheetsService.js.map +1 -1
- package/build/src/vendored/services/SheetsService.test.js +67 -0
- package/build/src/vendored/services/SheetsService.test.js.map +1 -1
- package/build/src/vendored/utils/textBounds.d.ts +40 -0
- package/build/src/vendored/utils/textBounds.d.ts.map +1 -0
- package/build/src/vendored/utils/textBounds.js +115 -0
- package/build/src/vendored/utils/textBounds.js.map +1 -0
- package/build/tsconfig.tsbuildinfo +1 -1
- package/package.json +3 -3
package/NOTICE
CHANGED
|
@@ -15,8 +15,13 @@ is unparseable or names a file that is not on disk -- an empty list would otherw
|
|
|
15
15
|
These no longer match gemini-cli-extensions/workspace byte-for-byte. `sync-upstream.mjs` reports them
|
|
16
16
|
as CONFLICT and leaves them alone; whoever syncs merges them by hand:
|
|
17
17
|
|
|
18
|
-
- src/vendored/services/
|
|
19
|
-
|
|
18
|
+
- src/vendored/services/DocsService.ts — BOUNDS: `getText` caps the returned text
|
|
19
|
+
(20,000 characters by default, 1–100,000 via `limit`, 2,000 via `preview`) and ends a cut body with the
|
|
20
|
+
shared truncation marker that names its true size.
|
|
21
|
+
- src/vendored/services/DriveService.ts — SECURITY: Prevent path traversal in relative localPath; BOUNDS:
|
|
22
|
+
`getComments` takes `pageSize`/`pageToken` and returns `nextPageToken` instead of a bare array that
|
|
23
|
+
dropped the cursor.
|
|
24
|
+
- src/vendored/services/CalendarService.ts — PERFORMANCE: Using Date.parse() instead of new Date().getTime() skips object allocation and reduces GC pressure; BOUNDS: `listEvents` takes `maxResults`/`pageToken` and returns `{events, nextPageToken}` instead of a bare array that dropped the cursor.
|
|
20
25
|
- src/vendored/utils/MimeHelper.ts — the multipart boundary suffix could be empty
|
|
21
26
|
(`.substring(7)` on a short `Math.random().toString(36)`, e.g. 0.5 -> "0.i"), so two messages
|
|
22
27
|
built in the same millisecond collided on their boundary. Now a randomUUID-derived suffix.
|
|
@@ -28,6 +33,8 @@ as CONFLICT and leaves them alone; whoever syncs merges them by hand:
|
|
|
28
33
|
(`.substring(7)` on a short `Math.random().toString(36)`, e.g. 0.5 -> "0.i"), so two messages
|
|
29
34
|
built in the same millisecond collided on their boundary. Now a randomUUID-derived suffix.
|
|
30
35
|
- src/vendored/utils/validation.ts — optimization: Date.parse vs new Date().getTime()
|
|
36
|
+
- src/vendored/services/ChatService.ts — BOUNDS: `listSpaces` takes `pageSize`/`pageToken` and returns
|
|
37
|
+
`{spaces, nextPageToken}` instead of a bare array that dropped the cursor.
|
|
31
38
|
|
|
32
39
|
## Files that replace an upstream file (ours, never synced)
|
|
33
40
|
|
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
> **ARCHIVED 2026-09-13** — This repository is no longer maintained. Use the official Google Workspace APIs instead of this MCP server. Existing installations keep working but receive no updates or support.
|
|
8
8
|
|
|
9
9
|
<p align="center">
|
|
10
|
-
<
|
|
10
|
+
<img alt="Mode: stdio · http remote oauth" src="https://img.shields.io/badge/mode-stdio_%C2%B7_http--remote--oauth-5C6BC0">
|
|
11
11
|
<a href="https://github.com/n24q02m/workspace/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/n24q02m/workspace/actions/workflows/ci.yml/badge.svg"></a>
|
|
12
12
|
<a href="https://github.com/n24q02m/workspace/actions/workflows/cd.yml"><img alt="CD" src="https://github.com/n24q02m/workspace/actions/workflows/cd.yml/badge.svg"></a>
|
|
13
13
|
<a href="https://codecov.io/gh/n24q02m/workspace"><img alt="codecov" src="https://codecov.io/gh/n24q02m/workspace/graph/badge.svg"></a>
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
</p>
|
|
18
18
|
|
|
19
19
|
<p align="center">
|
|
20
|
-
<a href="https://
|
|
20
|
+
<a href="https://docs.n24q02m.com/servers/workspace/">Docs</a> ·
|
|
21
21
|
<a href="#install">Install</a> ·
|
|
22
22
|
<a href="#quick-start">Quick start</a> ·
|
|
23
23
|
<a href="https://github.com/n24q02m/workspace/discussions">Community</a>
|
|
@@ -37,7 +37,7 @@
|
|
|
37
37
|
| [better-notion-mcp](https://github.com/n24q02m/better-notion-mcp) | Markdown-first Notion for AI agents -- pages, databases, blocks, and comments... | MCP |
|
|
38
38
|
| [better-semantic-release](https://github.com/n24q02m/better-semantic-release) | Drop-in python-semantic-release fork with built-in release-safety guards (orp... | Tooling |
|
|
39
39
|
| [better-telegram-mcp](https://github.com/n24q02m/better-telegram-mcp) | Telegram for AI agents -- messages, chats, media, and contacts across both bo... | MCP |
|
|
40
|
-
| [
|
|
40
|
+
| [workspace](https://github.com/n24q02m/workspace) | Google Workspace MCP server (Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch... | MCP |
|
|
41
41
|
| [claude-plugins](https://github.com/n24q02m/claude-plugins) | Claude Code plugin marketplace for the n24q02m MCP servers -- install web sea... | Marketplace |
|
|
42
42
|
| [imagine-mcp](https://github.com/n24q02m/imagine-mcp) | Image and video understanding + generation for AI agents -- across Gemini, Op... | MCP |
|
|
43
43
|
| [jules-task-archiver](https://github.com/n24q02m/jules-task-archiver) | Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a... | Tooling |
|
|
@@ -57,6 +57,7 @@
|
|
|
57
57
|
- [Install](#install)
|
|
58
58
|
- [Remote (HTTP mode)](#remote-http-mode)
|
|
59
59
|
- [Tools](#tools)
|
|
60
|
+
- [CLI](#cli)
|
|
60
61
|
- [Quick start](#quick-start)
|
|
61
62
|
- [Multi-account](#multi-account)
|
|
62
63
|
- [Documentation](#documentation)
|
|
@@ -87,9 +88,11 @@ stdio, add it to your MCP client config:
|
|
|
87
88
|
```
|
|
88
89
|
|
|
89
90
|
The package is `@n24q02m/workspace` (formerly `@n24q02m/better-workspace-mcp`;
|
|
90
|
-
old package receives one final release then freezes). The MCP Registry id
|
|
91
|
-
`io.github.n24q02m/
|
|
92
|
-
|
|
91
|
+
old package receives one final release then freezes). The MCP Registry id is now
|
|
92
|
+
`io.github.n24q02m/workspace`; the entry published under
|
|
93
|
+
`io.github.n24q02m/better-workspace-mcp` stays on the registry as a frozen
|
|
94
|
+
historical release, and the legacy `better-workspace-mcp` command is kept as an
|
|
95
|
+
alias of `workspace`.
|
|
93
96
|
|
|
94
97
|
Those two values come from an OAuth 2.0 client of type **Desktop app**, created in
|
|
95
98
|
the [Google Cloud Console](https://console.cloud.google.com/apis/credentials)
|
|
@@ -100,8 +103,9 @@ not on a public URL. Enable the Workspace APIs you plan to call on the same
|
|
|
100
103
|
project, and add yourself as a test user while the consent screen is unpublished.
|
|
101
104
|
|
|
102
105
|
The first run opens the Google consent screen in your browser; the refresh token
|
|
103
|
-
is stored encrypted on your machine under `~/.
|
|
104
|
-
`~/.better-workspace
|
|
106
|
+
is stored encrypted on your machine under `~/.workspace/` (a store an earlier
|
|
107
|
+
release wrote under `~/.better-workspace/` is copied forward on the next start, and the
|
|
108
|
+
older `~/.better-workspace-mcp/` is read as a fallback), so later runs start without asking again.
|
|
105
109
|
|
|
106
110
|
The same server can also serve several people over HTTP -- see
|
|
107
111
|
[Remote (HTTP mode)](#remote-http-mode).
|
|
@@ -109,7 +113,7 @@ The same server can also serve several people over HTTP -- see
|
|
|
109
113
|
**Install with an AI agent** -- paste this to your AI coding agent:
|
|
110
114
|
|
|
111
115
|
> Install MCP server `workspace` following the steps at
|
|
112
|
-
> https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/
|
|
116
|
+
> https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/workspace/setup-with-agent.md
|
|
113
117
|
|
|
114
118
|
## Remote (HTTP mode)
|
|
115
119
|
|
|
@@ -160,10 +164,11 @@ and renames it on the way into the container.
|
|
|
160
164
|
| `GOOGLE_OAUTH_CLIENT_SECRET` | yes | Web client secret. Same. |
|
|
161
165
|
| `CREDENTIAL_SECRET` | yes | Derives the encryption key of each user's credential store. The server refuses to start without it, rather than fail in the middle of a user's consent. |
|
|
162
166
|
| `WORKSPACE_USERS_FILE` | yes in HTTP | Users file that maps each bearer token to a user namespace (hull `multi` auth). Unset uses hull's default location. |
|
|
167
|
+
| `WORKSPACE_DATA_DIR` | no | Base directory for the credential store (`<dir>/.workspace/`, one encrypted blob per user). Unset uses the home directory. A relative value is resolved under the home directory and must stay inside it, so use an absolute path for a mounted volume. |
|
|
163
168
|
| `PORT` | no | Listen port. `0` (the default) asks the OS for a free one. |
|
|
164
169
|
| `HOST` | no | Bind address. Defaults to loopback, so a container needs `0.0.0.0`. |
|
|
165
170
|
|
|
166
|
-
Credentials are stored on local disk under `~/.
|
|
171
|
+
Credentials are stored on local disk under `~/.workspace/`, which is the data volume in the container. A store from an earlier release (`~/.better-workspace/`) is copied forward on startup, and the older `~/.better-workspace-mcp/` is read as a fallback.
|
|
167
172
|
|
|
168
173
|
`docker-compose.http.yml` in this repo is these variables written out as a
|
|
169
174
|
runnable overlay.
|
|
@@ -185,13 +190,88 @@ One composite tool per Workspace domain, plus `config` and `help`:
|
|
|
185
190
|
| `people` | Profile lookups -- `getMe`, `getUserProfile`, `getUserRelations` |
|
|
186
191
|
| `forms` | Forms -- `create`, `get`, `batchUpdate`, `listResponses`, `getResponse` |
|
|
187
192
|
| `time` | Local date/time/timezone helpers (no Google account needed) |
|
|
188
|
-
| `config` | Credential state and account management |
|
|
193
|
+
| `config` | Credential state and account management (CLI: `config-tool`) |
|
|
189
194
|
| `help` | Full documentation for any tool |
|
|
190
195
|
|
|
191
196
|
Questions are added to a form with `forms(action="batchUpdate")`, not at `create`;
|
|
192
197
|
responses are read-only, because the Forms API cannot write one. Listing or
|
|
193
198
|
deleting forms goes through `drive`.
|
|
194
199
|
|
|
200
|
+
### Response size
|
|
201
|
+
|
|
202
|
+
A Google read can return megabytes from one call, so every action whose payload
|
|
203
|
+
can grow is bounded by default:
|
|
204
|
+
|
|
205
|
+
- 20,000 characters per response. Raise it with `max_chars` (1--100,000), or pass
|
|
206
|
+
`full: true` for the complete payload. The same envelope `docs` exposes as
|
|
207
|
+
`limit`/`preview` and `sheets` as `max_chars`/`full`.
|
|
208
|
+
- Listings that page keep their page size (default 20, clamped to 1--100) and
|
|
209
|
+
always return their `nextPageToken`; listings with no cursor (`getImages`,
|
|
210
|
+
`findFolder`, `findSpaceByName`, `listCalendars`, `getUserRelations`, free/busy
|
|
211
|
+
slots, labels) also cap how many items one response carries (50--100).
|
|
212
|
+
- Truncation is never silent. A cut payload carries
|
|
213
|
+
`_truncation: {truncated, total_characters, returned_characters, omitted_items?, note}`
|
|
214
|
+
whose `note` reads
|
|
215
|
+
`[Content truncated: showing <kept> of <total> characters (<omitted> omitted). ...]`.
|
|
216
|
+
A JSON payload stays parseable, and a pagination cursor is never cut.
|
|
217
|
+
|
|
218
|
+
```sh
|
|
219
|
+
workspace gmail get --messageId <id> --max_chars 60000 --json # a longer body
|
|
220
|
+
workspace slides getText --presentationId <id> --full --json # the whole deck
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
## CLI
|
|
224
|
+
|
|
225
|
+
Every tool is also a shell subcommand, so the same operations work without an MCP
|
|
226
|
+
client. `workspace <tool> <action>` turns those parameters into the tool's input
|
|
227
|
+
object and calls the same handler the server registers -- one dispatch, two front
|
|
228
|
+
doors, so credential gating and validation behave identically.
|
|
229
|
+
|
|
230
|
+
```sh
|
|
231
|
+
workspace <tool> <action> [--param <value>]... [--json]
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
`--json` prints one envelope on stdout -- `{"tool", "action", "result"}`, where
|
|
235
|
+
`result` is the tool's own payload (parsed when the tool emits JSON, the raw text
|
|
236
|
+
otherwise). Without it you get the tool's text as-is. A tool failure prints to
|
|
237
|
+
stderr and exits 1; argv the CLI cannot parse exits 2. `workspace --help` lists the
|
|
238
|
+
tool subcommands and the operator commands (`auth`, `config`, `status`, `logout`,
|
|
239
|
+
`doctor`, `token`) separately, and `workspace <tool> --help` prints that tool's
|
|
240
|
+
actions and options.
|
|
241
|
+
|
|
242
|
+
One tool name is already taken. `config` is the operator command that reads the
|
|
243
|
+
credential store hull manages (`workspace config status`); the MCP `config` tool
|
|
244
|
+
is a different surface -- credential lifecycle plus the Google accounts the
|
|
245
|
+
server acts as. It keeps a console path under the alias `config-tool`, so neither
|
|
246
|
+
command can silently stand in for the other:
|
|
247
|
+
|
|
248
|
+
```sh
|
|
249
|
+
workspace config-tool status --json
|
|
250
|
+
workspace config-tool account_list
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
| Group | Example |
|
|
254
|
+
| --- | --- |
|
|
255
|
+
| `docs` | `workspace docs getText --documentId <document-id> --limit 2000` |
|
|
256
|
+
| `drive` | `workspace drive search --query "name contains 'Q3 report'" --pageSize 5` |
|
|
257
|
+
| `calendar` | `workspace calendar listCalendars --json` |
|
|
258
|
+
| `chat` | `workspace chat listSpaces --json` |
|
|
259
|
+
| `gmail` | `workspace gmail search --query "is:unread" --maxResults 5 --json` |
|
|
260
|
+
| `sheets` | `workspace sheets getRange --spreadsheetId <spreadsheet-id> --range "Sheet1!A1:C10"` |
|
|
261
|
+
| `slides` | `workspace slides getMetadata --presentationId <presentation-id>` |
|
|
262
|
+
| `tasks` | `workspace tasks listTasks --taskListId <task-list-id> --maxResults 20` |
|
|
263
|
+
| `people` | `workspace people getMe --json` |
|
|
264
|
+
| `forms` | `workspace forms listResponses --formId <form-id> --pageSize 10` |
|
|
265
|
+
| `time` | `workspace time getCurrentTime --json` |
|
|
266
|
+
| `config-tool` | `workspace config-tool status --json` (the MCP `config` tool) |
|
|
267
|
+
| `help` | `workspace help gmail` |
|
|
268
|
+
|
|
269
|
+
Values are coerced from the tool's own schema: `--maxResults 5` is a number,
|
|
270
|
+
`--includeSpamTrash` (also `--includeSpamTrash true`, or `--no-includeSpamTrash`)
|
|
271
|
+
is a boolean, and `--labelIds INBOX,IMPORTANT` (or a JSON array) is a list. Every
|
|
272
|
+
domain accepts `--account <email>` to choose the Google account, exactly like the
|
|
273
|
+
tool's `account` parameter.
|
|
274
|
+
|
|
195
275
|
## Quick start
|
|
196
276
|
|
|
197
277
|
Check that the credentials landed, with the `config` tool. Before the first
|
|
@@ -202,6 +282,9 @@ is acting as:
|
|
|
202
282
|
{ "action": "status" }
|
|
203
283
|
```
|
|
204
284
|
|
|
285
|
+
From a shell the same call is `workspace config-tool status --json`, and it works
|
|
286
|
+
before consent -- it reads the store, it does not need Google.
|
|
287
|
+
|
|
205
288
|
Then call a domain tool. On `docs`, `create` returns the new document's ID, which
|
|
206
289
|
`getText` reads back:
|
|
207
290
|
|
|
@@ -241,6 +324,18 @@ Accounts are managed through the `config` tool:
|
|
|
241
324
|
| `config(action="account_remove", account="<email>")` | Forget one account. |
|
|
242
325
|
| `config(action="account_set_default", account="<email>")` | Make one account the primary. |
|
|
243
326
|
|
|
327
|
+
From a shell, the same four calls:
|
|
328
|
+
|
|
329
|
+
```sh
|
|
330
|
+
workspace config-tool account_add
|
|
331
|
+
workspace config-tool account_list
|
|
332
|
+
workspace config-tool account_remove --account <email>
|
|
333
|
+
workspace config-tool account_set_default --account <email>
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
`config-tool`, not `config`: the plain name is the operator command that reads the
|
|
337
|
+
credential store.
|
|
338
|
+
|
|
244
339
|
The first account authorized becomes the primary. Removing the primary promotes
|
|
245
340
|
one of the remaining accounts; removing the last one puts the server back to
|
|
246
341
|
awaiting setup. Naming an account that is not configured is an error that names
|
|
@@ -303,11 +398,9 @@ replaced in place, so nothing else changes.
|
|
|
303
398
|
|
|
304
399
|
## Documentation
|
|
305
400
|
|
|
306
|
-
Full docs at **[
|
|
401
|
+
Full docs at **[docs.n24q02m.com/servers/workspace/](https://docs.n24q02m.com/servers/workspace/)**:
|
|
307
402
|
|
|
308
|
-
- [Setup](https://
|
|
309
|
-
- [Modes overview](https://mcp.n24q02m.com/get-started/modes-overview/) -- stdio (default) and HTTP (multi-user, bearer tokens)
|
|
310
|
-
- [Multi-user setup](https://mcp.n24q02m.com/get-started/multi-user/) -- the per-namespace credential model behind [Remote (HTTP mode)](#remote-http-mode)
|
|
403
|
+
- [Setup](https://docs.n24q02m.com/servers/workspace/setup/) -- plugin install, Docker stdio, and Docker HTTP methods
|
|
311
404
|
|
|
312
405
|
Every tool also documents itself at runtime: call `help` for the full reference on
|
|
313
406
|
any of them, including the exact parameters each action takes.
|