google-workspace

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Google Workspace Skill

Comprehensive MCP integration for all Google Workspace services.

针对所有Google Workspace服务的全面MCP集成。

Denotation

指称

Google Workspace tasks map to functional invariants, resulting in consistent email, file, calendar, and task states under Narya condensation and GF(3) conservation.

The skill reaches a fixed point when all pending operations complete with no H¹ obstructions (gluing failures), and thread/folder trit sums are conserved modulo 3.

Google Workspace任务映射到函数不变量，在Narya condensation和GF(3)守恒规则下，确保邮件、文件、日历和任务状态的一致性。

当所有待处理操作完成且无H¹障碍（粘合失败），并且线程/文件夹的trit总和模3守恒时，该技能达到不动点。

Formal Contract

正式契约

Effect: Google Workspace → State × Trit
Invariant: ∀ closed workflow: Σ(trit) ≡ 0 (mod 3)
Denotation: ⟦GW⟧ = lim_{n→∞} Condense(Op_n(...Op_1(S_0)))

Effect: Google Workspace → State × Trit
Invariant: ∀ closed workflow: Σ(trit) ≡ 0 (mod 3)
Denotation: ⟦GW⟧ = lim_{n→∞} Condense(Op_n(...Op_1(S_0)))

Required Parameter

必填参数

All tools require
user_google_email
- the user's Google email address.

所有工具均需
user_google_email
- 用户的Google邮箱地址。

Services Overview

服务概述

📧 Gmail (MINUS -1: Validator)

📧 Gmail（MINUS -1：验证器）

Tool	Description
`search_gmail_messages`	Search with Gmail query syntax
`get_gmail_message_content`	Get full message content
`get_gmail_messages_content_batch`	Batch get (max 25)
`get_gmail_thread_content`	Get full conversation thread
`send_gmail_message`	Send email (supports replies)
`draft_gmail_message`	Create draft (supports replies)
`modify_gmail_message_labels`	Add/remove labels (archive, delete)
`batch_modify_gmail_message_labels`	Bulk label operations
`list_gmail_labels`	List all labels with IDs
`manage_gmail_label`	Create/update/delete labels

Query syntax examples:

```
from:user@example.com
```
- From specific sender
```
is:unread
```
- Unread messages
```
has:attachment
```
- Has attachments
```
after:2024/01/01
```
- Date filters

工具	描述
`search_gmail_messages`	使用Gmail查询语法进行搜索
`get_gmail_message_content`	获取完整邮件内容
`get_gmail_messages_content_batch`	批量获取（最多25条）
`get_gmail_thread_content`	获取完整对话线程内容
`send_gmail_message`	发送邮件（支持回复）
`draft_gmail_message`	创建草稿（支持回复）
`modify_gmail_message_labels`	添加/移除标签（归档、删除）
`batch_modify_gmail_message_labels`	批量标签操作
`list_gmail_labels`	列出所有带ID的标签
`manage_gmail_label`	创建/更新/删除标签

查询语法示例：

```
from:user@example.com
```
- 来自特定发件人
```
is:unread
```
- 未读邮件
```
has:attachment
```
- 包含附件
```
after:2024/01/01
```
- 日期筛选

📁 Drive (ERGODIC 0: Coordinator)

📁 Drive（ERGODIC 0：协调器）

Tool	Description
`search_drive_files`	Search files by query
`list_drive_items`	List folder contents
`get_drive_file_content`	Get file content (text extraction)
`get_drive_file_download_url`	Get download URL
`create_drive_file`	Create new file
`update_drive_file`	Update metadata
`share_drive_file`	Share with users/groups/anyone
`batch_share_drive_file`	Bulk sharing
`get_drive_file_permissions`	Check permissions
`get_drive_shareable_link`	Get shareable link
`remove_drive_permission`	Revoke access
`transfer_drive_ownership`	Transfer file ownership

工具	描述
`search_drive_files`	通过查询搜索文件
`list_drive_items`	列出文件夹内容
`get_drive_file_content`	获取文件内容（文本提取）
`get_drive_file_download_url`	获取下载链接
`create_drive_file`	创建新文件
`update_drive_file`	更新元数据
`share_drive_file`	与用户/群组/所有人共享
`batch_share_drive_file`	批量共享操作
`get_drive_file_permissions`	查看权限
`get_drive_shareable_link`	获取可共享链接
`remove_drive_permission`	撤销访问权限
`transfer_drive_ownership`	转移文件所有权

📅 Calendar (PLUS +1: Executor)

📅 Calendar（PLUS +1：执行器）

Tool	Description
`list_calendars`	List user's calendars
`get_events`	Get events (by ID or time range)
`create_event`	Create new event
`modify_event`	Update existing event
`delete_event`	Delete event

Event creation options:

```
add_google_meet: true
```
- Add Meet link
```
attendees: ["email1", "email2"]
```
- Invite attendees

reminders: [{"method": "popup", "minutes": 15}]

- Custom reminders

```
transparency: "transparent"
```
- Show as available

工具	描述
`list_calendars`	列出用户的日历
`get_events`	获取事件（按ID或时间范围）
`create_event`	创建新事件
`modify_event`	更新现有事件
`delete_event`	删除事件

事件创建选项：

```
add_google_meet: true
```
- 添加Meet链接
```
attendees: ["email1", "email2"]
```
- 邀请参会者

reminders: [{"method": "popup", "minutes": 15}]

- 自定义提醒

```
transparency: "transparent"
```
- 显示为空闲状态

📄 Docs (MINUS -1)

📄 Docs（MINUS -1）

Tool	Description
`search_docs`	Search Google Docs
`list_docs_in_folder`	List docs in folder
`create_doc`	Create new document
`get_doc_content`	Get document content
`modify_doc_text`	Insert/replace/format text
`find_and_replace_doc`	Find and replace
`insert_doc_image`	Insert image
`insert_doc_elements`	Insert table/list/page break
`create_table_with_data`	Create populated table
`inspect_doc_structure`	Get document structure
`debug_table_structure`	Debug table layout
`update_doc_headers_footers`	Update headers/footers
`batch_update_doc`	Multiple operations
`export_doc_to_pdf`	Export to PDF

工具	描述
`search_docs`	搜索Google Docs
`list_docs_in_folder`	列出文件夹中的文档
`create_doc`	创建新文档
`get_doc_content`	获取文档内容
`modify_doc_text`	插入/替换/格式化文本
`find_and_replace_doc`	查找并替换
`insert_doc_image`	插入图片
`insert_doc_elements`	插入表格/列表/分页符
`create_table_with_data`	创建带数据的表格
`inspect_doc_structure`	获取文档结构
`debug_table_structure`	调试表格布局
`update_doc_headers_footers`	更新页眉/页脚
`batch_update_doc`	多操作批量执行
`export_doc_to_pdf`	导出为PDF

📊 Sheets (ERGODIC 0)

📊 Sheets（ERGODIC 0）

Tool	Description
`list_spreadsheets`	List spreadsheets
`create_spreadsheet`	Create new spreadsheet
`get_spreadsheet_info`	Get spreadsheet metadata
`create_sheet`	Add new sheet
`read_sheet_values`	Read cell range
`modify_sheet_values`	Write/update/clear cells

Range syntax:

Sheet1!A1:D10

A1:Z1000

工具	描述
`list_spreadsheets`	列出电子表格
`create_spreadsheet`	创建新电子表格
`get_spreadsheet_info`	获取电子表格元数据
`create_sheet`	添加新工作表
`read_sheet_values`	读取单元格范围
`modify_sheet_values`	写入/更新/清除单元格

范围语法：

Sheet1!A1:D10

或

A1:Z1000

📽️ Slides (PLUS +1)

📽️ Slides（PLUS +1）

Tool	Description
`create_presentation`	Create new presentation
`get_presentation`	Get presentation details
`get_page`	Get slide details
`get_page_thumbnail`	Get slide thumbnail
`batch_update_presentation`	Apply updates

工具	描述
`create_presentation`	创建新演示文稿
`get_presentation`	获取演示文稿详情
`get_page`	获取幻灯片详情
`get_page_thumbnail`	获取幻灯片缩略图
`batch_update_presentation`	应用更新操作

📋 Forms

Tool	Description
`create_form`	Create new form
`get_form`	Get form details
`list_form_responses`	List responses
`get_form_response`	Get specific response
`set_publish_settings`	Update publish settings

工具	描述
`create_form`	创建新表单
`get_form`	获取表单详情
`list_form_responses`	列出表单回复
`get_form_response`	获取特定回复
`set_publish_settings`	更新发布设置

✅ Tasks

Tool	Description
`list_task_lists`	List all task lists
`get_task_list`	Get task list details
`create_task_list`	Create new list
`update_task_list`	Rename list
`delete_task_list`	Delete list
`list_tasks`	List tasks in list
`get_task`	Get task details
`create_task`	Create task
`update_task`	Update task
`delete_task`	Delete task
`move_task`	Move task (position/list)
`clear_completed_tasks`	Clear completed

工具	描述
`list_task_lists`	列出所有任务列表
`get_task_list`	获取任务列表详情
`create_task_list`	创建新列表
`update_task_list`	重命名列表
`delete_task_list`	删除列表
`list_tasks`	列出列表中的任务
`get_task`	获取任务详情
`create_task`	创建任务
`update_task`	更新任务
`delete_task`	删除任务
`move_task`	移动任务（调整位置/转移列表）
`clear_completed_tasks`	清除已完成任务

💬 Chat

Tool	Description
`list_spaces`	List Chat spaces
`get_messages`	Get messages from space
`search_messages`	Search messages
`send_message`	Send message to space

工具	描述
`list_spaces`	列出Chat空间
`get_messages`	获取空间中的消息
`search_messages`	搜索消息
`send_message`	向空间发送消息

🔍 Custom Search

🔍 自定义搜索

Tool	Description
`search_custom`	Programmable Search Engine
`search_custom_siterestrict`	Site-restricted search
`get_search_engine_info`	Get search engine config

工具	描述
`search_custom`	可编程搜索引擎
`search_custom_siterestrict`	站点限制搜索
`get_search_engine_info`	获取搜索引擎配置

💬 Comments (All Doc Types)

💬 评论（所有文档类型）

Tool	Description
`read_document_comments`	Read doc comments
`create_document_comment`	Add doc comment
`reply_to_document_comment`	Reply to comment
`resolve_document_comment`	Resolve comment
`read_spreadsheet_comments`	Read sheet comments
`create_spreadsheet_comment`	Add sheet comment
`read_presentation_comments`	Read slide comments
`create_presentation_comment`	Add slide comment

工具	描述
`read_document_comments`	读取文档评论
`create_document_comment`	添加文档评论
`reply_to_document_comment`	回复评论
`resolve_document_comment`	标记评论为已解决
`read_spreadsheet_comments`	读取表格评论
`create_spreadsheet_comment`	添加表格评论
`read_presentation_comments`	读取幻灯片评论
`create_presentation_comment`	添加幻灯片评论

GF(3) Triadic Workflow

GF(3)三元工作流

MINUS (-1): Validation/Reading
├── search_gmail_messages
├── get_doc_content
├── read_sheet_values
└── list_drive_items

ERGODIC (0): Coordination/Metadata
├── get_spreadsheet_info
├── list_calendars
├── inspect_doc_structure
└── get_drive_file_permissions

PLUS (+1): Execution/Writing
├── send_gmail_message
├── create_event
├── modify_sheet_values
└── create_drive_file

MINUS (-1): 验证/读取
├── search_gmail_messages
├── get_doc_content
├── read_sheet_values
└── list_drive_items

ERGODIC (0): 协调/元数据
├── get_spreadsheet_info
├── list_calendars
├── inspect_doc_structure
└── get_drive_file_permissions

PLUS (+1): 执行/写入
├── send_gmail_message
├── create_event
├── modify_sheet_values
└── create_drive_file

Common Workflows

常见工作流

Email Management

邮件管理

python

undefined

python

undefined

Search → Read → Reply

搜索 → 读取 → 回复

messages = search_gmail_messages(query="from:boss is:unread") content = get_gmail_message_content(message_id=messages[0].id) send_gmail_message( to="boss@company.com", subject="Re: " + content.subject, body="Response...", thread_id=content.thread_id, in_reply_to=content.message_id )

undefined

undefined

Document Creation

文档创建

python

undefined

python

undefined

Create → Inspect → Add Table

创建 → 检查 → 添加表格

doc = create_doc(title="Report") structure = inspect_doc_structure(document_id=doc.id) create_table_with_data( document_id=doc.id, index=structure.total_length, table_data=[["Header1", "Header2"], ["Data1", "Data2"]] )

undefined

undefined

Calendar Scheduling

日历日程安排

python

undefined

python

undefined

Check availability → Create event with Meet

查看可用时间 → 创建带Meet的事件

events = get_events( time_min="2024-12-26T09:00:00Z", time_max="2024-12-26T17:00:00Z" ) create_event( summary="Team Sync", start_time="2024-12-26T14:00:00Z", end_time="2024-12-26T15:00:00Z", attendees=["team@company.com"], add_google_meet=True )

undefined

undefined

File Sharing

文件共享

python

undefined

python

undefined

Share with expiration

带过期时间的共享

share_drive_file( file_id="abc123", share_with="contractor@example.com", role="writer", expiration_time="2025-01-15T00:00:00Z" )

undefined

share_drive_file( file_id="abc123", share_with="contractor@example.com", role="writer", expiration_time="2025-01-15T00:00:00Z" )

undefined

Authentication

认证

If tools fail with auth errors, use:

start_google_auth(service_name="gmail|drive|calendar|docs|sheets|slides|forms|tasks|chat")

如果工具因认证错误失败，请使用：

start_google_auth(service_name="gmail|drive|calendar|docs|sheets|slides|forms|tasks|chat")

Tips

提示

Batch operations - Use batch tools for multiple items
Table creation - Always call
```
inspect_doc_structure
```
first to get safe index
Email threading - Include
```
thread_id
```
,
```
in_reply_to
```
,
```
references
```
for proper replies
Drive shared drives - Use
```
drive_id
```
parameter for shared drive operations
Calendar attachments - Use Drive file URLs or IDs for event attachments

批量操作 - 对多个项目使用批量工具
表格创建 - 始终先调用
```
inspect_doc_structure
```
以获取安全的插入索引
邮件线程 - 包含
```
thread_id
```
、
```
in_reply_to
```
、
```
references
```
以确保回复正确关联线程
Drive共享驱动器 - 对共享驱动器操作使用
```
drive_id
```
参数
日历附件 - 使用Drive文件链接或ID作为事件附件

Related Skills (Backlinks)

Skill	Trit	Integration
finder-color-walk	0	Drive files ↔ local Finder GF(3) coloring via `drive_color_walk.py`
gay-mcp	+1	SplitMix64 deterministic colors for file organization
triad-interleave	+1	Schedule Drive operations in GF(3)-balanced triplets
bisimulation-game	-1	Verify Drive state equivalence across agents

技能	Trit	集成方式
finder-color-walk	0	Drive文件 ↔ 本地Finder GF(3)着色，通过 `drive_color_walk.py`
gay-mcp	+1	SplitMix64确定性颜色用于文件组织
triad-interleave	+1	按GF(3)平衡三元组安排Drive操作
bisimulation-game	-1	跨Agent验证Drive状态等价性

Triadic Integration Pattern

三元集成模式

google-workspace (ERGODIC 0) ─── Coordinator
        │
        ├── finder-color-walk (0) ─── File coloring bridge
        │       └── drive_color_walk.py
        │
        ├── gay-mcp (+1) ─── Color generation
        │       └── SplitMix64 seeds → GF(3) trits
        │
        └── bisimulation-game (-1) ─── State verification
                └── Attacker/Defender/Arbiter protocol

GF(3) Check: 0 + 0 + 1 + (-1) = 0 ✓

google-workspace (ERGODIC 0) ─── 协调器
        │
        ├── finder-color-walk (0) ─── 文件着色桥接
        │       └── drive_color_walk.py
        │
        ├── gay-mcp (+1) ─── 颜色生成
        │       └── SplitMix64种子 → GF(3) trits
        │
        └── bisimulation-game (-1) ─── 状态验证
                └── 攻击者/防御者/仲裁者协议

GF(3) 检查: 0 + 0 + 1 + (-1) = 0 ✓

Invariant Set

不变量集合

Invariant	Definition	Verification
`NoDuplication`	Each item (message, event, file) resides in exactly one triadic queue	Queue intersection = ∅
`RouteInvariance`	`route(item) = agent_of(trit(item))` always	For all items, routing is deterministic
`ThreadConservation`	Thread trit sum ≡ 0 (mod 3) at cycle close	`verify_h1_obstruction()` returns no violations
`ClosedWorkflowBalance`	Any complete workflow has Σ trits = 0	GF(3) conservation check

不变量	定义	验证方式
`NoDuplication`	每个项目（邮件、事件、文件）恰好属于一个三元队列	队列交集 = ∅
`RouteInvariance`	`route(item) = agent_of(trit(item))` 始终成立	所有项目的路由均为确定性
`ThreadConservation`	周期结束时线程trit总和 ≡ 0 (mod 3)	`verify_h1_obstruction()` 返回无违规
`ClosedWorkflowBalance`	任何完整工作流的trit总和为0	GF(3)守恒检查

Narya Compatibility

Narya兼容性

Field	Definition	Example
`before`	Raw input from Google APIs	`{"messages": [...], "files": [...]}`
`after`	Transformed interactions with GF(3) trits	`[{id, trit, verb, thread_id}]`
`delta`	Change in triadic queue state	`{added: 3, removed: 1, trit_sum_delta: +1}`
`birth`	Initial unprocessed state	Empty queues, no interactions
`impact`	1 if equivalence class changed, 0 otherwise	Used for ANIMA detection

字段	定义	示例
`before`	来自Google API的原始输入	`{"messages": [...], "files": [...]}`
`after`	带GF(3) trits的转换后交互数据	`[{id, trit, verb, thread_id}]`
`delta`	三元队列状态的变化	`{added: 3, removed: 1, trit_sum_delta: +1}`
`birth`	初始未处理状态	空队列，无交互
`impact`	若等价类发生变化则为1，否则为0	用于ANIMA检测

Condensation Policy

压缩策略

Trigger: When 10 consecutive operations yield no change in equivalence classes.

python

def should_condense(history: List[State], threshold: int = 10) -> bool:
    if len(history) < threshold:
        return False
    recent = history[-threshold:]
    return all(equiv(s) == equiv(recent[0]) for s in recent)

Action: Collapse queue state into condensed fingerprint, archive processed items.

触发条件：当连续10次操作未改变等价类时。

python

def should_condense(history: List[State], threshold: int = 10) -> bool:
    if len(history) < threshold:
        return False
    recent = history[-threshold:]
    return all(equiv(s) == equiv(recent[0]) for s in recent)

操作：将队列状态压缩为指纹，归档已处理项目。

Scientific Skill Interleaving

科学技能交叉

This skill connects to the K-Dense-AI/claude-scientific-skills ecosystem:

本技能连接到K-Dense-AI/claude-scientific-skills生态系统：

Graph Theory

图论

networkx [○] via bicomodule
- Universal graph hub

networkx [○] 通过双余模
- 通用图枢纽

Bibliography References

参考文献

```
general
```
: 734 citations in bib.duckdb

```
general
```
: bib.duckdb中734次引用

SDF Interleaving

SDF交叉

This skill connects to Software Design for Flexibility (Hanson & Sussman, 2021):

本技能连接到Software Design for Flexibility（Hanson & Sussman, 2021）：

Primary Chapter: 10. Adventure Game Example

核心章节：10. 冒险游戏示例

Concepts: autonomous agent, game, synthesis

概念：自主Agent、游戏、合成

GF(3) Balanced Triad

GF(3)平衡三元组

google-workspace (○) + SDF.Ch10 (+) + [balancer] (−) = 0

Skill Trit: 0 (ERGODIC - coordination)

google-workspace (○) + SDF.Ch10 (+) + [balancer] (−) = 0

技能Trit：0（ERGODIC - 协调）

Secondary Chapters

次要章节

Ch7: Propagators
Ch6: Layering
Ch4: Pattern Matching
Ch2: Domain-Specific Languages
Ch1: Flexibility through Abstraction

Ch7: 传播器
Ch6: 分层
Ch4: 模式匹配
Ch2: 领域特定语言
Ch1: 通过抽象实现灵活性

Connection Pattern

连接模式

Adventure games synthesize techniques. This skill integrates multiple patterns.

冒险游戏综合多种技术。本技能集成了多种模式。

Cat# Integration

Cat#集成

This skill maps to Cat# = Comod(P) as a bicomodule in the equipment structure:

Trit: 0 (ERGODIC)
Home: Prof
Poly Op: ⊗
Kan Role: Adj
Color: #26D826

本技能在装备结构中映射为Cat# = Comod(P)，作为双余模：

Trit: 0 (ERGODIC)
Home: Prof
Poly Op: ⊗
Kan Role: Adj
Color: #26D826

GF(3) Naturality

GF(3)自然性

The skill participates in triads satisfying:

(-1) + (0) + (+1) ≡ 0 (mod 3)

This ensures compositional coherence in the Cat# equipment structure.

本技能参与满足以下条件的三元组：

(-1) + (0) + (+1) ≡ 0 (mod 3)

google-workspace

Original

Translation

Google Workspace Skill

Google Workspace Skill

Denotation

指称

Formal Contract

正式契约

Required Parameter

必填参数

Services Overview

服务概述

📧 Gmail (MINUS -1: Validator)

📧 Gmail（MINUS -1：验证器）

📁 Drive (ERGODIC 0: Coordinator)

📁 Drive（ERGODIC 0：协调器）

📅 Calendar (PLUS +1: Executor)

📅 Calendar（PLUS +1：执行器）

📄 Docs (MINUS -1)

📄 Docs（MINUS -1）

📊 Sheets (ERGODIC 0)

📊 Sheets（ERGODIC 0）

📽️ Slides (PLUS +1)

📽️ Slides（PLUS +1）

📋 Forms

📋 Forms

✅ Tasks

✅ Tasks

💬 Chat

💬 Chat

🔍 Custom Search

🔍 自定义搜索

💬 Comments (All Doc Types)

💬 评论（所有文档类型）

GF(3) Triadic Workflow

GF(3)三元工作流

Common Workflows

常见工作流

Email Management

邮件管理

Search → Read → Reply

搜索 → 读取 → 回复

Document Creation

文档创建

Create → Inspect → Add Table

创建 → 检查 → 添加表格

Calendar Scheduling

日历日程安排

Check availability → Create event with Meet

查看可用时间 → 创建带Meet的事件

File Sharing

文件共享

Share with expiration

带过期时间的共享

Authentication

认证

Tips

提示

Related Skills (Backlinks)

相关技能（反向链接）

Triadic Integration Pattern

三元集成模式

Invariant Set

不变量集合

Narya Compatibility

Narya兼容性

Condensation Policy

压缩策略

Scientific Skill Interleaving

科学技能交叉

Graph Theory

图论

Bibliography References

参考文献

SDF Interleaving

SDF交叉

Primary Chapter: 10. Adventure Game Example

核心章节：10. 冒险游戏示例

GF(3) Balanced Triad