google-docs-connector

# Google Docs Connector ## Freshness Last updated: `2026-08-05`. If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples. ## What This Tool Does Comprehensive Google Docs management tool enabling AI agents to create edit format and share documents through OAuth authentication. Supports rich text formatting with bold italic underline strikethrough and custom fonts paragraph styling with alignment spacing and indentation table creation and manipulation image insertion from URLs headers footers and page breaks named ranges for bookmarking document export to multiple formats including PDF DOCX HTML and EPUB sharing and permission management and natural language document creation. Perfect for document automation report generation collaborative editing template creation and content management workflows. ## Product Instructions ### Google Docs Create, edit, format, and share Google Docs. Search for documents by name. #### Parameters - `action` (string, required): Action to perform. Use get_instructions for full details. - `document_id` (string): Google Docs document ID (from the document URL). Required for most actions except create_document, search_documents, quick_create. - `tab_id` (string): Target tab for tab-scoped updates. Get this from `get_document` → `tabs[].tab_id`. Indexed updates default to the first tab when omitted. `replace_text` applies to all tabs when omitted. - `title` (string): Document title. Required for: create_document - `query` (string): Search term for search_documents. Matches document names (contains match). - `max_results` (integer, default 20, range 1-100): Maximum results for search_documents - `text` (string): Text content for insert_text, create_document (initial content), replace_text, quick_create - `location` (integer): Zero-based UTF-16 code-unit index for insertions. Defaults to `1`, normally the beginning of a tab body. - `range_start` (integer): Zero-based, inclusive UTF-16 code-unit start index for format_text and create_named_range. - `range_end` (integer): Zero-based, exclusive UTF-16 code-unit end index for format_text and create_named_range. - `search_text` (string): Text to find. Required for: replace_text - `replace_with` (string): Replacement text. Required for: replace_text - `match_case` (boolean, default false): Case-sensitive search for replace_text - `requests` (array of objects): Raw batch update requests for batch_update - `text_style` (object): Styling: bold, italic, underline, strikethrough, font_family, font_size, foreground_color, background_color, link - `paragraph_style` (object): Styling: named_style_type (NORMAL_TEXT, TITLE, SUBTITLE, HEADING_1 through HEADING_6), alignment (START/CENTER/END/JUSTIFIED), line_spacing (100/150/200), indents - `rows` (integer, 1-100): Table rows for create_table - `columns` (integer, 1-20): Table columns for create_table - `table_data` (array of arrays): 2D string array of cell data for create_table - `image_url` (string): Publicly accessible image URL for insert_image - `width` (integer): Image width in pixels - `height` (integer): Image height in pixels - `export_format` (string): One of: pdf, docx, odt, rtf, txt, html, epub, zip - `share_with` (array of objects): Each with `email`, `role` (reader/writer/commenter), `type` (user/group/domain/anyone) - `send_notification` (boolean, default true): Send email when sharing - `email_message` (string): Custom sharing notification message #### Actions ##### `get_instructions` Returns this documentation. ##### `create_document` Creates a new Google Doc. Required: `title` Optional: `text` (initial content) ##### `get_document` Retrieves content and indexed structure from every document tab, including nested child tabs. Required: `document_id` The response includes a flattened `tabs` array in UI order. Each item contains `tab_id`, title/hierarchy metadata, extracted `text_content`, and the complete `document_tab` structure with Google-provided `startIndex` and `endIndex` values. Use those returned indices and the matching `tab_id` for subsequent updates. Indices are zero-based UTF-16 code-unit offsets; `startIndex` is inclusive and `endIndex` is exclusive. Refetch the document after edits that can shift indices. ##### `search_documents` Searches for Google Docs by name. Returns documents sorted by most recently modified. Optional: `query` (name contains match), `max_results` If `query` is omitted, lists recent Google Docs. ##### `insert_text` Inserts text at a specific position. Required: `document_id`, `text` Optional: `location` (default: 1), `tab_id` ##### `replace_text` Finds and replaces all occurrences of text. Required: `document_id`, `search_text`, `replace_with` Optional: `match_case`, `tab_id`. If `tab_id` is omitted, replacement applies to all tabs. ##### `format_text` Applies text and paragraph styling to a range. Required: `document_id`, `range_start`, `range_end`, and at least one of `text_style` or `paragraph_style` Optional: `tab_id` ##### `update_style` Alias for format_text. ##### `insert_image` Inserts an inline image. Required: `document_id`, `image_url` Optional: `location`, `width`, `height`, `tab_id` ##### `create_table` Inserts a table, optionally populated with data. Required: `document_id` Optional: `rows`, `columns`, `table_data`, `location`, `tab_id` If `table_data` is provided, dimensions are inferred from it. ##### `insert_page_break` Required: `document_id` Optional: `location`, `tab_id` ##### `insert_section_break` Required: `document_id` Optional: `location`, `tab_id` ##### `create_header` Required: `document_id` Optional: `header_type` (DEFAULT, FIRST_PAGE, EVEN_PAGE, ODD_PAGE), `text` ##### `create_footer` Required: `document_id` Optional: `footer_type` (DEFAULT, FIRST_PAGE, EVEN_PAGE, ODD_PAGE) ##### `create_named_range` Required: `document_id`, `range_name`, `range_start`, `range_end` Optional: `tab_id` ##### `export_document` Exports to another format. Text formats return content directly; binary formats return base64. Required: `document_id`, `export_format` ##### `share_document` Sets sharing permissions via Google Drive. Required: `document_id`, `share_with` Optional: `send_notification`, `email_message` ##### `get_permissions` Lists current sharing settings. Required: `document_id` ##### `batch_update` Executes raw Google Docs API batch update requests for advanced operations. Required: `document_id`, `requests` For a request containing a `range` or `location`, put `tabId` inside that raw range/location. The top-level `tab_id` parameter is not injected into raw requests. ##### `quick_create` Creates a document from a natural language description. Required: `text` Optional: `title` #### Examples ```json {"action":"search_documents","query":"meeting notes"} ``` ```json {"action":"search_documents","query":"Q1 report","max_results":5} ``` ```json {"action":"create_document","title":"Meeting Notes","text":"Agenda:\n1. Review\n2. Planning"} ``` ```json {"action":"get_document","document_id":"1a2b3c4d5e"} ``` ```json {"action":"insert_text","document_id":"1a2b3c4d5e","tab_id":"t.abc123","text":"New paragraph\n","location":1} ``` ```json {"action":"replace_text","document_id":"1a2b3c4d5e","search_text":"draft","replace_with":"final"} ``` ```json {"action":"format_text","document_id":"1a2b3c4d5e","tab_id":"t.abc123","range_start":1,"range_end":10,"text_style":{"bold":true,"font_size":{"magnitude":14,"unit":"PT"}}} ``` Apply a real heading style in a specific tab: ```json {"action":"format_text","document_id":"1a2b3c4d5e","tab_id":"t.abc123","range_start":1,"range_end":18,"paragraph_style":{"named_style_type":"HEADING_1"}} ``` Create a real numbered list in a specific tab using indices returned by `get_document`: ```json {"action":"batch_update","document_id":"1a2b3c4d5e","requests":[{"createParagraphBullets":{"range":{"tabId":"t.abc123","startIndex":20,"endIndex":58},"bulletPreset":"NUMBERED_DECIMAL_ALPHA_ROMAN"}}]} ``` ```json {"action":"export_document","document_id":"1a2b3c4d5e","export_format":"pdf"} ``` ```json {"action":"share_document","document_id":"1a2b3c4d5e","share_with":[{"email":"user@example.com","role":"writer","type":"user"}]} ``` #### Response All responses return `{"success": true, "output": { ... }}`. Output varies by action: - `search_documents` → `{"query": "...", "result_count": N, "documents": [{"document_id", "name", "modified_time", "web_view_link", ...}]}` - `create_document` → `{"document_id", "title", "revision_id"}` - `get_document` → `{"document_id", "title", "text_content", "word_count", "tab_count", "tabs", "index_semantics", "raw_document"}` - `replace_text` → `{"occurrences_changed": N}` - `export_document` → `{"content": "..."}` (text) or `{"content_base64": "..."}` (binary) - `share_document` → `{"permissions_added": N, "permissions": [...]}` - `get_permissions` → `{"permissions": [...]}` ## When To Use - Use this skill for `Google Docs Connector` on AgentPMT. - Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape. - Search and activation keywords: google docs connector, document automation, report generation, template creation, collaborative editing, batch update, document id, requests. - Supported action names: `batch_update`, `create_document`, `create_footer`, `create_header`, `create_named_range`, `create_table`, `export_document`, `format_text`, `get_document`, `get_permissions`, `insert_image`, `insert_page_break`, `insert_section_break`, `insert_text`, `quick_create`, `replace_text`, `search_documents`, `share_document`, `update_style`. ## Use Cases - document automation - report generation - template creation - collaborative editing - content management - proposal writing - meeting agenda creation - contract generation - documentation workflows - batch document processing ## Categories And Industries No categories or industry tags are published for this tool. ## Actions And Schema Complete generated action schema: `./schema.md`. Supported action count: `19`. x402 availability: not enabled for this product. - `batch_update` (action slug: `batch-update`): Execute raw Google Docs API batch update requests. Put tabId inside each raw range or location when targeting a non-first tab. Price: `5` credits. Parameters: `document_id`, `requests`. - `create_document` (action slug: `create-document`): Create a new Google Doc. Price: `5` credits. Parameters: `text`, `title`. - `create_footer` (action slug: `create-footer`): Add a footer to the document. Price: `5` credits. Parameters: `document_id`, `footer_type`. - `create_header` (action slug: `create-header`): Add a header to the document. Price: `5` credits. Parameters: `document_id`, `header_type`, `text`.