Skip to main content

Google Docs

Comprehensive Google Docs connector for creating, reading, and editing documents with support for text formatting, tables, images, named ranges, and headers/footers.

Categories: Document Management, Productivity, Collaboration

What you can ask​

  • Open the Q2 Strategy doc and summarize the section on pricing.
  • Create a new doc in the Engineering / RFCs folder titled 'Auth migration' from this template.
  • Find every doc in Shared drives / Sales last edited over 90 days ago.

Set up​

Google Docs needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Google Docs. Click Enable, and choose which tools to allow.
  2. Create a Google Cloud project.
  3. Turn on the Google Docs API.
  4. Configure the OAuth consent screen.
  5. Create credentials, choose OAuth client ID, and set the type to Web application.
  6. Add the exact Redirect URI shown in the connector settings.
  7. Copy the client ID and client secret into the connector, then save it.
  8. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Google Docs login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (2)

Grant the scopes for the tools you plan to allow.

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/documents.readonly

Tools​

Google Docs offers 46 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (6)​

View and search information without changing it.

ToolWhat it does
find_textFind literal text in a Google Docs document and return each match's UTF-16 start/end index and tab_id, ready to pass to insert_text, delete_text, or format_text.
get_documentRetrieve a Google Docs document's full structural JSON by ID: the index ranges needed to edit (insert/delete/replace by index), styling, and images.
get_document_end_indexGet the end index for appending content to a document
get_document_textRead a Google Docs document as lightweight markdown-lite text (headings, bullets, tab titles).
list_tabsList all tabs in a Google Docs document, returning tab IDs, titles, and nesting only (no document content).
validate_credentialValidate Google Docs credentials.

Write (17)​

Create or send data.

ToolWhat it does
append_textAppend text to the end of a document
create_and_populate_tableCreate and populate a table with data in one operation
create_documentCreate a new Google Docs document with optional title
create_footerCreate a footer section at a section break in a document
create_footnoteInsert a footnote reference at the given index.
create_headerCreate a header section at a section break in a document
create_named_rangeCreate a named range (bookmark) in a document
create_paragraph_bulletsApply bullet or numbered list formatting to all paragraphs that overlap a range.
create_tabCreate a new tab in a Google Docs document
insert_imageInsert an inline image at a specific location
insert_image_in_table_cellInsert an image into a table cell by table position
insert_section_breakInsert a section break at a specific index.
insert_tableInsert a table with specified rows and columns
insert_table_columnInsert a new column into an existing table
insert_table_rowInsert a new row into an existing table
insert_textInsert text at a specific location in a document
insert_text_in_table_cellInsert text into a table cell by table position

Delete or overwrite (23)​

Remove or replace existing data.

ToolWhat it does
batch_update_documentApply multiple updates to a document in a single operation
delete_footerDelete a footer section from a document
delete_headerDelete a header section from a document
delete_named_rangeDelete a named range from a document
delete_paragraph_bulletsRemove bullet/numbered list formatting from all paragraphs that overlap a range.
delete_tabDelete a tab from a Google Docs document by tab ID.
delete_table_columnDelete a column from an existing table
delete_table_rowDelete a row from an existing table
delete_textDelete text from a specified range in a document
format_paragraphApply paragraph formatting to a range in a document
format_textApply text formatting to a range in a document
merge_table_cellsMerge a rectangular block of table cells into one.
pin_table_header_rowsPin the first N rows of a table as headers that repeat at the top of every page break.
replace_named_range_contentReplace the content of a named range with new text.
replace_textFind and replace all occurrences of text in a document
unmerge_table_cellsReverse a previous merge_table_cells operation, restoring the cells in the specified range to individual cells.
update_document_styleSet page margins, page size, or background color on the document.
update_named_styleRedefine a named style document-wide (HEADING_1 through HEADING_6, NORMAL_TEXT, TITLE, SUBTITLE).
update_section_styleUpdate section style (columns, separator, content direction, margins) over a range.
update_tab_propertiesUpdate a tab's properties (e.g. rename it) in a Google Docs document
update_table_cell_styleUpdate visual styling on a single table cell - background color, borders, padding, vertical alignment.
update_table_column_propertiesSet width on one or more columns in a table.
update_table_row_styleSet minimum row height and/or overflow prevention on one or more rows in a table.
⌘J