Agent-Skills.md

Agent Skills: Google Workspace — 12 Services, 106 Tools

Google Workspace operations — Docs, Sheets, Drive, Apps Script, Gmail, Calendar, Tasks, Slides, Contacts, Chat, and Search. Use for creating, reading, editing Google Docs/Sheets/Slides. Use for Drive file management. Use for Calendar events and scheduling. Use for Gmail messages, labels, and filters. Use for Tasks, Contacts, and Chat.

UncategorizedID: anentrypoint/docmcp/agent-gsuite

Repository

anentrypoint/docmcp
AnEntrypoint
11

Install this agent skill to your local

pnpm dlx add-skill https://github.com/AnEntrypoint/agent-gsuite/tree/HEAD/skills/agent-gsuite

Skill Files

Browse the full folder contents for agent-gsuite.

Download Skill

Loading file tree…

skills/agent-gsuite/SKILL.md

Skill Metadata

Name
agent-gsuite
Description
Google Workspace operations — Docs, Sheets, Drive, Apps Script, Gmail, Calendar, Tasks, Slides, Contacts, Chat, and Search. Use for creating, reading, editing Google Docs/Sheets/Slides. Use for Drive file management. Use for Calendar events and scheduling. Use for Gmail messages, labels, and filters. Use for Tasks, Contacts, and Chat.

Google Workspace — 12 Services, 106 Tools

You have access to a CLI tool that performs all Google Workspace operations. Run it via:

node ~/.claude/skills/agent-gsuite/scripts/gsuite.mjs <command> '<json-args>'

All commands accept a single JSON argument. Output is always JSON.

Authentication

Tokens are stored at ~/.config/agent-gsuite/token.json. If tokens are missing, tell the user to run:

bun x agent-gsuite auth login

Or if bun is unavailable:

node ~/.claude/skills/agent-gsuite/scripts/gsuite.mjs auth

Commands Reference

Google Docs

| Command | JSON Args | Description | |---------|-----------|-------------| | docs.create | {"title": "..."} | Create a new doc | | docs.read | {"doc_id": "..."} | Read doc text content | | docs.edit | {"doc_id": "...", "old_text": "...", "new_text": "...", "replace_all": false} | Replace text in doc | | docs.insert | {"doc_id": "...", "text": "...", "position": "end"} | Insert text (position: "end", text-to-insert-after, or index number) | | docs.delete | {"doc_id": "...", "text": "...", "delete_all": false} | Delete text from doc | | docs.format | {"doc_id": "...", "search_text": "...", ...formatting} | Format text (bold, italic, underline, strikethrough, font_size, font_family, foreground_color, background_color, heading, alignment) | | docs.insert_table | {"doc_id": "...", "rows": 3, "cols": 3, "position": "end"} | Insert table | | docs.get_info | {"doc_id": "..."} | Get doc metadata | | docs.get_structure | {"doc_id": "..."} | Get headings hierarchy | | docs.get_sections | {"doc_id": "..."} | Parse sections with indices | | docs.section | {"doc_id": "...", "action": "delete\|move\|replace", "section": "name-or-index", ...} | Manage sections (target for move, content + preserve_heading for replace) | | docs.image | {"doc_id": "...", "action": "insert\|list\|delete\|replace", ...} | Manage images (image_url, image_index, position, width, height) | | docs.batch | {"doc_id": "...", "operations": [...]} | Batch operations (type: insert/delete/format with params) | | docs.list | {"max_results": 20, "query": "..."} | List docs | | docs_find_replace | {"doc_id": "...", "find_text": "...", "replace_text": "...", "match_case": false} | Find and replace all | | docs_export_pdf | {"doc_id": "..."} | Export doc as PDF (base64) | | docs_as_markdown | {"doc_id": "..."} | Get doc as markdown |

Google Sheets

| Command | JSON Args | Description | |---------|-----------|-------------| | sheets.create | {"title": "..."} | Create spreadsheet | | sheets.read | {"sheet_id": "...", "range": "Sheet1"} | Read values from range | | sheets.edit | {"sheet_id": "...", "range": "A1:B2", "values": [[...]]} | Update range values | | sheets.insert | {"sheet_id": "...", "values": [[...]], "range": "Sheet1"} | Append rows | | sheets.get_cell | {"sheet_id": "...", "cell": "A1"} | Get cell value | | sheets.set_cell | {"sheet_id": "...", "cell": "A1", "value": "..."} | Set cell value | | sheets.edit_cell | {"sheet_id": "...", "cell": "A1", "old_text": "...", "new_text": "...", "replace_all": false} | Replace text in cell | | sheets.find_replace | {"sheet_id": "...", "find": "...", "replace": "...", "sheet_name": null} | Find/replace across sheet | | sheets.get_info | {"sheet_id": "..."} | Get spreadsheet metadata | | sheets.list | {"max_results": 20, "query": "..."} | List spreadsheets | | sheets.tab | {"sheet_id": "...", "action": "add\|delete\|rename", "title": "...", "sheet_name": "..."} | Manage tabs | | sheets.clear | {"sheet_id": "...", "range": "A1:B2", "clear_formats": false} | Clear range | | sheets.format | {"sheet_id": "...", "range": "A1:B2", ...formatting} | Format range (background_color, text_color, bold, italic, font_size, font_family, horizontal_alignment, vertical_alignment, wrap_strategy, number_format, borders) | | sheets.merge | {"sheet_id": "...", "range": "A1:B2", "action": "merge\|unmerge"} | Merge/unmerge cells | | sheets.freeze | {"sheet_id": "...", "sheet_name": "...", "rows": 1, "columns": 0} | Freeze rows/columns | | sheets.sort | {"sheet_id": "...", "range": "A1:C10", "sort_column": "A", "ascending": true} | Sort range | | sheets.rows_cols | {"sheet_id": "...", "sheet_name": "...", "action": "insert\|delete", "dimension": "ROW\|COLUMN", "start_index": 0, "count": 1} | Insert/delete rows or columns | | sheets.dimension_size | {"sheet_id": "...", "sheet_name": "...", "dimension": "COLUMN\|ROW", "start": "A", "end": "C", "size": 150} | Set column width or row height | | sheets.get_formula | {"sheet_id": "...", "cell": "A1"} | Get cell formula and value | | sheets.batch | {"sheet_id": "...", "operations": [...]} | Batch operations (type: setValue/format) |

Google Drive

| Command | JSON Args | Description | |---------|-----------|-------------| | drive.search | {"query": "...", "type": "all\|docs\|sheets", "max_results": 20} | Search Drive | | drive_get_download_url | {"file_id": "..."} | Get download URL | | drive_copy | {"file_id": "...", "name": "...", "parent_folder_id": "..."} | Copy a file | | drive_manage_access | {"file_id": "...", "action": "share\|unshare\|list", "email": "...", "role": "reader\|writer"} | Manage file permissions |

Apps Script

| Command | JSON Args | Description | |---------|-----------|-------------| | scripts.create | {"sheet_id": "...", "script_name": "..."} | Create script project | | scripts.list | {"sheet_id": "..."} | List scripts | | scripts.read | {"sheet_id": "...", "script": "name-or-index"} | Read script files | | scripts.write | {"sheet_id": "...", "script": "...", "file_name": "...", "content": "...", "file_type": "SERVER_JS\|HTML"} | Write script file (full overwrite) | | scripts.edit | {"sheet_id": "...", "script": "...", "file_name": "...", "old_text": "...", "new_text": "...", "replace_all": false} | Edit script file (text replacement) | | scripts.delete | {"sheet_id": "...", "script": "..."} | Remove script tracking | | scripts.run | {"sheet_id": "...", "script": "...", "function_name": "...", "parameters": []} | Execute script function | | scripts.sync | {"sheet_id": "..."} | Sync and verify scripts |

Gmail — Messages

| Command | JSON Args | Description | |---------|-----------|-------------| | gmail.list_messages | {"query": "...", "max_results": 20, "label_ids": [...]} | List messages (query: "from:x@x.com", "is:unread", "subject:meeting") | | gmail.get_message | {"message_id": "...", "format": "full"} | Get message details (format: full, minimal, metadata) | | gmail.send_message | {"to": "...", "subject": "...", "body": "...", "from": "...", "cc": "...", "bcc": "..."} | Send email | | gmail.list_threads | {"query": "...", "max_results": 10} | List threads | | gmail.get_thread | {"thread_id": "...", "format": "full"} | Get thread details | | gmail.modify_message | {"message_id": "...", "add_labels": [...], "remove_labels": [...]} | Modify message labels | | gmail.trash_message | {"message_id": "..."} | Move message to trash | | gmail.delete_message | {"message_id": "..."} | Permanently delete message | | gmail_get_attachments | {"message_id": "..."} | List message attachments | | gmail_download_attachment | {"message_id": "...", "attachment_id": "..."} | Download attachment as base64 | | gmail_bulk_modify_labels | {"query": "...", "add_labels": [...], "remove_labels": [...], "max_results": 2000} | Bulk label modification by query |

Gmail — Labels

| Command | JSON Args | Description | |---------|-----------|-------------| | gmail.list_labels | {} | List all Gmail labels with counts and metadata | | gmail_create_label | {"name": "...", "label_list_visibility": "...", "message_list_visibility": "...", "color": {"text_color": "#000", "background_color": "#fff"}} | Create label | | gmail_update_label | {"label_id": "...", "name": "...", ...} | Update label | | gmail_delete_label | {"label_id": "..."} | Delete label |

Gmail — Filters

| Command | JSON Args | Description | |---------|-----------|-------------| | gmail_list_filters | {} | List all Gmail filters | | gmail_get_filter | {"filter_id": "..."} | Get filter details | | gmail_create_filter | {"criteria": {"from": "...", "subject": "...", "has_attachment": true, ...}, "action": {"add_label_ids": [...], "remove_label_ids": [...], "forward": "..."}} | Create filter | | gmail_delete_filter | {"filter_id": "..."} | Delete filter | | gmail_replace_filter | {"filter_id": "...", "criteria": {...}, "action": {...}} | Replace filter (Gmail has no native update API) | | gmail_draft | {"to": "...", "subject": "...", "body": "...", "cc": "...", "bcc": "..."} | Create draft email | | gmail_get_thread | {"thread_id": "...", "format": "full"} | Get full thread content | | gmail_batch_get | {"message_ids": [...], "format": "full"} | Batch get messages |

Google Calendar

| Command | JSON Args | Description | |---------|-----------|-------------| | calendar_list | {} | List all calendars | | calendar_get_events | {"calendar_id": "primary", "time_min": "...", "time_max": "...", "query": "...", "max_results": 25, "detailed": false} | Get events | | calendar_manage_event | {"action": "create\|update\|delete\|rsvp", "summary": "...", "start_time": "...", "end_time": "...", "event_id": "...", "attendees": [...], "add_google_meet": true} | Manage events | | calendar_freebusy | {"time_min": "...", "time_max": "...", "calendar_ids": ["primary"]} | Query free/busy | | calendar_create | {"summary": "...", "description": "...", "timezone": "..."} | Create calendar | | calendar_out_of_office | {"action": "list\|create\|delete", "start_time": "...", "end_time": "..."} | Manage OOO | | calendar_focus_time | {"action": "list\|create\|delete", "start_time": "...", "end_time": "..."} | Manage focus time |

Google Tasks

| Command | JSON Args | Description | |---------|-----------|-------------| | tasks_list_lists | {} | List task lists | | tasks_get_list | {"tasklist_id": "..."} | Get task list | | tasks_manage_list | {"action": "create\|update\|delete\|clear", "title": "..."} | Manage task lists | | tasks_list | {"tasklist_id": "@default", "show_completed": true} | List tasks | | tasks_get | {"tasklist_id": "...", "task_id": "..."} | Get task | | tasks_manage | {"action": "create\|update\|delete\|move", "title": "...", "due": "...", "status": "needsAction\|completed"} | Manage tasks |

Google Slides

| Command | JSON Args | Description | |---------|-----------|-------------| | slides_create | {"title": "..."} | Create presentation | | slides_get | {"presentation_id": "..."} | Get presentation metadata | | slides_batch_update | {"presentation_id": "...", "requests": [...]} | Batch update | | slides_get_page | {"presentation_id": "...", "page_id": "..."} | Get page elements | | slides_get_thumbnail | {"presentation_id": "...", "page_id": "...", "mime_type": "PNG"} | Get slide thumbnail |

Google Contacts

| Command | JSON Args | Description | |---------|-----------|-------------| | contacts_list | {"page_size": 100} | List contacts | | contacts_get | {"resource_name": "people/c123"} | Get contact | | contacts_search | {"query": "..."} | Search contacts | | contacts_manage | {"action": "create\|update\|delete", "given_name": "...", "emails": [...], "phones": [...]} | Manage contacts | | contacts_list_groups | {} | List groups | | contacts_get_group | {"resource_name": "..."} | Get group | | contacts_batch | {"action": "add_to_group\|remove_from_group", "resource_names": [...], "group_resource_name": "..."} | Batch group ops | | contacts_manage_group | {"action": "create\|update\|delete", "name": "..."} | Manage groups |

Google Chat

| Command | JSON Args | Description | |---------|-----------|-------------| | chat_list_spaces | {} | List Chat spaces | | chat_get_messages | {"space_name": "spaces/AAAA", "page_size": 25} | Get messages | | chat_send_message | {"space_name": "...", "text": "...", "thread_key": "..."} | Send message | | chat_search_messages | {"query": "..."} | Search messages | | chat_create_reaction | {"message_name": "...", "emoji": "👍"} | Add reaction | | chat_download_attachment | {"attachment_name": "..."} | Download attachment |

Google Custom Search

| Command | JSON Args | Description | |---------|-----------|-------------| | search_custom | {"query": "...", "num": 10, "site_search": "...", "file_type": "pdf"} | Web search (requires GOOGLE_API_KEY) | | search_engine_info | {"search_engine_id": "..."} | Get search engine info |

Usage Pattern

Always use this exact invocation pattern:

node ~/.claude/skills/agent-gsuite/scripts/gsuite.mjs <command> '<json-args>'

Example: Create a document:

node ~/.claude/skills/agent-gsuite/scripts/gsuite.mjs docs.create '{"title":"Meeting Notes"}'

Example: Read a spreadsheet:

node ~/.claude/skills/agent-gsuite/scripts/gsuite.mjs sheets.read '{"sheet_id":"1abc...xyz","range":"Sheet1!A1:D10"}'

Example: Format text bold in a doc:

node ~/.claude/skills/agent-gsuite/scripts/gsuite.mjs docs.format '{"doc_id":"1abc...xyz","search_text":"Important","bold":true}'

Example: Search Gmail for unread emails:

node ~/.claude/skills/agent-gsuite/scripts/gsuite.mjs gmail.list_messages '{"query":"is:unread","max_results":10}'

Example: Create a Gmail filter:

node ~/.claude/skills/agent-gsuite/scripts/gsuite.mjs gmail_create_filter '{"criteria":{"from":"newsletter@example.com"},"action":{"add_label_ids":["Label_123"],"remove_label_ids":["INBOX"]}}'