google-workspace

Google Workspace Skill

Comprehensive MCP integration for all Google Workspace services.

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.

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)))

Required Parameter

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

Services Overview

📧 Gmail (MINUS -1: Validator)

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

📁 Drive (ERGODIC 0: Coordinator)

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

📅 Calendar (PLUS +1: Executor)

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

📄 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

📊 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 or A1:Z1000

📽️ 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

📋 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

✅ 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

💬 Chat

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

🔍 Custom Search

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

💬 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

GF(3) Triadic Workflow

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

Common Workflows

Email Management

# 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
)

Document Creation

# 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"]]
)

Calendar Scheduling

# Check availability → Create event with 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
)

File Sharing

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

Authentication

If tools fail with auth errors, use:

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

Tips

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

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

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 ✓

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

Narya Compatibility

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

Condensation Policy

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

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.

Scientific Skill Interleaving

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

Graph Theory

• networkx [○] via bicomodule
  • Universal graph hub

Bibliography References

• general: 734 citations in bib.duckdb

Cat# Integration

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

GF(3) Naturality

The skill participates in triads satisfying:

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

This ensures compositional coherence in the Cat# equipment structure.