How do I install the Agent Gsuite skill?

Run npx skillmds@latest add anentrypoint/agent-gsuite in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Agent Gsuite skill do?

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. It is listed under AI & ML on SkillMD.

Is Agent Gsuite safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agent Gsuite?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agent Gsuite free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agent Gsuite?

anentrypoint (@anentrypoint) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agent Gsuite by anentrypoint — Agent Skill

Name: Agent Gsuite
Author: anentrypoint

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"]}}'

Agent Gsuite

File contents

Google Workspace — 12 Services, 106 Tools

Authentication

Commands Reference

Google Docs

Google Sheets

Google Drive

Apps Script

Gmail — Messages

Gmail — Labels

Gmail — Filters

Google Calendar

Google Tasks

Google Slides

Google Contacts

Google Chat

Google Custom Search

Usage Pattern

Frequently asked questions

Agent Gsuite

File contents

Google Workspace — 12 Services, 106 Tools

Authentication

Commands Reference

Google Docs

Google Sheets

Google Drive

Apps Script

Gmail — Messages

Gmail — Labels

Gmail — Filters

Google Calendar

Google Tasks

Google Slides

Google Contacts

Google Chat

Google Custom Search

Usage Pattern

Related skills

Frequently asked questions

How do I install the Agent Gsuite skill?

What does the Agent Gsuite skill do?

Is Agent Gsuite safe to use?

Which AI agents work with Agent Gsuite?

Is Agent Gsuite free to use?

Who published Agent Gsuite?