google-workspace

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Google Workspace (No MCP)

Google Workspace（无需MCP）

Use this skill when the user wants Google Workspace access in pi without MCP.

This skill provides local Node.js helper scripts for:

OAuth login + token management
Direct Google API calls (generic and convenience commands)

当用户希望在pi中无需MCP即可访问Google Workspace时，可使用此skill。

该skill提供本地Node.js辅助脚本，用于：

OAuth登录 + 令牌管理
直接调用Google API（通用命令和便捷命令）

Files

文件

```
scripts/auth.js
```
— login/status/clear token
```
scripts/workspace.js
```
— call APIs
```
scripts/common.js
```
— shared auth logic

```
scripts/auth.js
```
— 登录/状态查询/清除令牌
```
scripts/workspace.js
```
— 调用API
```
scripts/common.js
```
— 共享认证逻辑

One-time setup

一次性设置

Dependencies auto-install on first script run (
```
auth.js
```
or
```
workspace.js
```
).

Optional (to prewarm manually):

bash

cd /Users/mitsuhiko/Development/agent-stuff/skills/google-workspace
npm install

Auth mode defaults to cloud (same hosted OAuth approach used by the workspace extension), so no local
```
credentials.json
```
is required.

Optional local OAuth mode:

Set
```
GOOGLE_WORKSPACE_AUTH_MODE=local
```
Create a Google OAuth Desktop app and place credentials at:

bash

~/.pi/google-workspace/credentials.json

Environment overrides:

```
GOOGLE_WORKSPACE_CONFIG_DIR
```
```
GOOGLE_WORKSPACE_CREDENTIALS
```
```
GOOGLE_WORKSPACE_TOKEN
```
```
GOOGLE_WORKSPACE_AUTH_MODE
```
(
```
cloud
```
or
```
local
```
)
```
GOOGLE_WORKSPACE_CLIENT_ID
```
(cloud mode)
```
GOOGLE_WORKSPACE_CLOUD_FUNCTION_URL
```
(cloud mode)

首次运行脚本（
```
auth.js
```
或
```
workspace.js
```
）时会自动安装依赖。

可选操作（手动预安装依赖）：

bash

cd /Users/mitsuhiko/Development/agent-stuff/skills/google-workspace
npm install

认证模式默认为云端（与workspace扩展使用相同的托管OAuth方式），因此无需本地
```
credentials.json
```
文件。

可选的本地OAuth模式：

设置环境变量
```
GOOGLE_WORKSPACE_AUTH_MODE=local
```
创建Google OAuth桌面应用，并将凭据文件放置在以下路径：

bash

~/.pi/google-workspace/credentials.json

环境变量覆盖项：

```
GOOGLE_WORKSPACE_CONFIG_DIR
```
```
GOOGLE_WORKSPACE_CREDENTIALS
```
```
GOOGLE_WORKSPACE_TOKEN
```
```
GOOGLE_WORKSPACE_AUTH_MODE
```
（
```
cloud
```
或
```
local
```
）
```
GOOGLE_WORKSPACE_CLIENT_ID
```
（云端模式）
```
GOOGLE_WORKSPACE_CLOUD_FUNCTION_URL
```
（云端模式）

Authenticate

认证

bash

cd /Users/mitsuhiko/Development/agent-stuff/skills/google-workspace
node scripts/auth.js login

This opens the browser for OAuth consent automatically. If you run an API call without a token,

workspace.js

will also trigger the same browser auth flow.

Check auth status:

bash

node scripts/auth.js status

Clear token:

bash

node scripts/auth.js clear

bash

cd /Users/mitsuhiko/Development/agent-stuff/skills/google-workspace
node scripts/auth.js login

此命令会自动打开浏览器进行OAuth授权。如果您在没有令牌的情况下调用API，

workspace.js

也会触发相同的浏览器认证流程。

查询认证状态：

bash

node scripts/auth.js status

清除令牌：

bash

node scripts/auth.js clear

API usage

API使用方法

Generic API call

通用API调用

bash

node scripts/workspace.js call <service> <method.path> '<json params>'

Examples:

bash

node scripts/workspace.js call drive files.list '{"pageSize":5,"fields":"files(id,name)"}'
node scripts/workspace.js call calendar events.list '{"calendarId":"primary","maxResults":10,"singleEvents":true,"orderBy":"startTime"}'
node scripts/workspace.js call docs documents.get '{"documentId":"<DOC_ID>"}'

bash

node scripts/workspace.js call <service> <method.path> '<json params>'

示例：

bash

node scripts/workspace.js call drive files.list '{"pageSize":5,"fields":"files(id,name)"}'
node scripts/workspace.js call calendar events.list '{"calendarId":"primary","maxResults":10,"singleEvents":true,"orderBy":"startTime"}'
node scripts/workspace.js call docs documents.get '{"documentId":"<DOC_ID>"}'

Convenience commands

便捷命令

bash

node scripts/workspace.js calendar-today
node scripts/workspace.js drive-search "name contains 'Roadmap' and trashed=false"
node scripts/workspace.js gmail-search "from:alice@example.com newer_than:7d"

bash

node scripts/workspace.js calendar-today
node scripts/workspace.js drive-search "name contains 'Roadmap' and trashed=false"
node scripts/workspace.js gmail-search "from:alice@example.com newer_than:7d"

Operational guidance for the agent

Agent操作指南

Always run
```
node scripts/auth.js status
```
first.
If auth is missing/expired, run
```
node scripts/auth.js login
```
immediately and wait for user to complete browser consent.
Do not just explain setup unless a command actually failed and its error output requires user action.
Use
```
workspace.js call
```
for precise operations and return raw JSON results.
For user-friendly output, post-process JSON after the call.
Never print token contents back to the user.

始终先运行
```
node scripts/auth.js status
```
。
如果认证缺失/过期，立即运行
```
node scripts/auth.js login
```
，并等待用户完成浏览器授权。
除非命令实际失败且错误输出需要用户操作，否则不要仅解释设置步骤。
使用
```
workspace.js call
```
执行精确操作，并返回原始JSON结果。
若要输出用户友好的内容，需在调用后对JSON进行后处理。
绝不要将令牌内容打印给用户。