Skip to Content

Google Docs

Google Docs icon
Arcade Optimized

Arcade.dev LLM tools for Google Docs

Author:Arcade
Version:5.0.1
Auth:User authorization via the Google auth provider
13tools
1require secrets
PyPI VersionPython VersionsWheel StatusDownloadsLicense

Arcade.dev offers a toolkit for Google Docs that facilitates seamless interaction with Google Drive and document management. This toolkit enables developers to create, edit, and manage documents through a variety of functions in a secure environment.

Capabilities

  • Create, edit, and comment on Google Docs seamlessly.
  • Retrieve document metadata and manage file permissions securely.
  • Generate user-friendly file picker URLs for easy file access.
  • List and manage comments within documents.

OAuth Provider: Google Scopes: https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile

Secrets Secret Type: API Key Example: OPENAI_API_KEY.

Available tools(13)

13 of 13
Tool nameDescriptionSecrets
Comment on a specific document by its ID.
Create a blank Google Docs document with the specified title.
Create a Google Docs document with the specified title and text content.
Edit a Google Docs document with the specified edit request. This tool does not have context about previous edits because it is stateless. If your edit request depends on knowledge about previous edits, then you should provide that context in the edit requests.
1
Generate a Google File Picker URL for user-driven file selection and authorization. This tool generates a URL that directs the end-user to a Google File Picker interface where where they can select or upload Google Drive files. Users can grant permission to access their Drive files, providing a secure and authorized way to interact with their files. This is particularly useful when prior tools (e.g., those accessing or modifying Google Docs, Google Sheets, etc.) encountered failures due to file non-existence (Requested entity was not found) or permission errors. Once the user completes the file picker flow, the prior tool can be retried. Suggest this tool to users when they are surprised or confused that the file they are searching for or attempting to access cannot be found.
Get the latest version of the specified Google Docs document as DocMD. The DocMD output will include tags that can be used to annotate the document with location information, the type of block, block IDs, and other metadata. If the document has tabs, all tabs are included in sequential order unless a specific tab_id is provided.
DEPRECATED DO NOT USE THIS TOOL Get the latest version of the specified Google Docs document.
Get metadata for a Google Docs document including hierarchical tab structure. Returns document title, ID, URL, total character count, and nested tab information with character counts for each tab.
Updates an existing Google Docs document using the batchUpdate API endpoint.
List all comments on the specified Google Docs document.
Searches for documents in the user's Google Drive and returns documents with their main body content and tab metadata. Excludes documents that are in the trash. Returns main body content only with metadata about tabs. Use get_document_as_docmd() to retrieve full tab content for specific documents. Use search_documents() for metadata-only searches.
Searches for documents in the user's Google Drive. Excludes documents in trash. Returns metadata only. Use get_document_metadata or get_document_as_docmd for content.
Get comprehensive user profile and Google Docs environment information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Google Docs access permissions, and other important profile details from Google services.

Selected tools

No tools selected.

Click "Show all tools" to add tools.

Requirements

Select tools to see requirements

#

GoogleDocs.CommentOnDocument

Comment on a specific document by its ID.

Parameters

ParameterTypeReq.Description
document_idstringRequiredThe ID of the document to comment on
comment_textstringRequiredThe comment to add to the document

Requirements

No secrets required

Output

Type:jsonThe comment's ID, documentId, and documentUrl in a dictionary
#

GoogleDocs.CreateBlankDocument

Create a blank Google Docs document with the specified title.

Parameters

ParameterTypeReq.Description
titlestringRequiredThe title of the blank document to create

Requirements

No secrets required

Output

Type:jsonThe created document's title, documentId, and documentUrl in a dictionary
#

GoogleDocs.CreateDocumentFromText

Create a Google Docs document with the specified title and text content.

Parameters

ParameterTypeReq.Description
titlestringRequiredThe title of the document to create
text_contentstringRequiredThe text content to insert into the document

Requirements

No secrets required

Output

Type:jsonThe created document's title, documentId, and documentUrl in a dictionary
#

GoogleDocs.EditDocument

Edit a Google Docs document with the specified edit request. This tool does not have context about previous edits because it is stateless. If your edit request depends on knowledge about previous edits, then you should provide that context in the edit requests.

Parameters

ParameterTypeReq.Description
document_idstringRequiredThe ID of the document to edit
edit_requestsarray<string>RequiredA list of natural language descriptions of the desired change(s) to the document. Each entry should be a single, self-contained edit request that can be fully understood independently. Note: Each request may result in zero, one, or multiple actual edits depending on what changes are needed (e.g., a request might be ignored if the change already exists in the document).
reasoning_effortstringOptionalThe effort to put into reasoning about the edit(s). Defaults to medium
minimallowmediumhigh

Requirements

Secrets:OPENAI_API_KEY

Output

Type:jsonThe edited document's title, documentId, and documentUrl in a dictionary
#

GoogleDocs.GenerateGoogleFilePickerUrl

Generate a Google File Picker URL for user-driven file selection and authorization. This tool generates a URL that directs the end-user to a Google File Picker interface where where they can select or upload Google Drive files. Users can grant permission to access their Drive files, providing a secure and authorized way to interact with their files. This is particularly useful when prior tools (e.g., those accessing or modifying Google Docs, Google Sheets, etc.) encountered failures due to file non-existence (Requested entity was not found) or permission errors. Once the user completes the file picker flow, the prior tool can be retried. Suggest this tool to users when they are surprised or confused that the file they are searching for or attempting to access cannot be found.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:jsonGoogle File Picker URL for user file selection and permission granting
#

GoogleDocs.GetDocumentAsDocmd

Get the latest version of the specified Google Docs document as DocMD. The DocMD output will include tags that can be used to annotate the document with location information, the type of block, block IDs, and other metadata. If the document has tabs, all tabs are included in sequential order unless a specific tab_id is provided.

Parameters

ParameterTypeReq.Description
document_idstringRequiredThe ID of the document to retrieve.
tab_idstringOptionalThe ID of a specific tab to retrieve. If provided, returns only content from that tab. If omitted, returns all tabs in sequential depth-first order.

Requirements

No secrets required

Output

Type:stringThe document contents as DocMD
#

GoogleDocs.GetDocumentById

DEPRECATED DO NOT USE THIS TOOL Get the latest version of the specified Google Docs document.

Parameters

ParameterTypeReq.Description
document_idstringRequiredThe ID of the document to retrieve.

Requirements

No secrets required

Output

Type:jsonThe document contents as a dictionary
#

GoogleDocs.GetDocumentMetadata

Get metadata for a Google Docs document including hierarchical tab structure. Returns document title, ID, URL, total character count, and nested tab information with character counts for each tab.

Parameters

ParameterTypeReq.Description
document_idstringRequiredThe ID of the document to get metadata for

Requirements

No secrets required

Output

Type:jsonDocument metadata including hierarchical tab structure
#

GoogleDocs.InsertTextAtEndOfDocument

Updates an existing Google Docs document using the batchUpdate API endpoint.

Parameters

ParameterTypeReq.Description
document_idstringRequiredThe ID of the document to update.
text_contentstringRequiredThe text content to insert into the document

Requirements

No secrets required

Output

Type:jsonThe response from the batchUpdate API as a dict.
#

GoogleDocs.ListDocumentComments

List all comments on the specified Google Docs document.

Parameters

ParameterTypeReq.Description
document_idstringRequiredThe ID of the document to list comments for
include_deletedbooleanOptionalWhether to include deleted comments in the results. Defaults to False.

Requirements

No secrets required

Output

Type:jsonA dictionary containing the comments
#

GoogleDocs.SearchAndRetrieveDocuments

Searches for documents in the user's Google Drive and returns documents with their main body content and tab metadata. Excludes documents that are in the trash. Returns main body content only with metadata about tabs. Use get_document_as_docmd() to retrieve full tab content for specific documents. Use search_documents() for metadata-only searches.

Parameters

ParameterTypeReq.Description
return_formatstringOptionalThe format of the document to return. Defaults to Markdown.
docmdmarkdownhtmlgoogle_api_json
document_containsarray<string>OptionalKeywords or phrases that must be in the document title or body. Provide a list of keywords or phrases if needed.
document_not_containsarray<string>OptionalKeywords or phrases that must NOT be in the document title or body. Provide a list of keywords or phrases if needed.
search_only_in_shared_drive_idstringOptionalThe ID of the shared drive to restrict the search to. If provided, the search will only return documents from this drive. Defaults to None, which searches across all drives.
include_shared_drivesbooleanOptionalWhether to include documents from shared drives. Defaults to False (searches only in the user's 'My Drive').
include_organization_domain_documentsbooleanOptionalWhether to include documents from the organization's domain. This is applicable to admin users who have permissions to view organization-wide documents in a Google Workspace account. Defaults to False.
order_byarray<string>OptionalSort order. Defaults to listing the most recently modified documents first
createdTimecreatedTime descfolderfolder descmodifiedByMeTimemodifiedByMeTime descmodifiedTimemodifiedTime descnamename descname_naturalname_natural descquotaBytesUsedquotaBytesUsed descrecencyrecency descsharedWithMeTimesharedWithMeTime descstarredstarred descviewedByMeTimeviewedByMeTime desc
limitintegerOptionalThe number of documents to list
pagination_tokenstringOptionalThe pagination token to continue a previous request

Requirements

No secrets required

Output

Type:jsonA dictionary containing document count, list of documents with content and metadata, pagination token, and has_more flag
#

GoogleDocs.SearchDocuments

Searches for documents in the user's Google Drive. Excludes documents in trash. Returns metadata only. Use get_document_metadata or get_document_as_docmd for content.

Parameters

ParameterTypeReq.Description
document_containsarray<string>OptionalKeywords or phrases that must be in the document title or body. Provide a list of keywords or phrases if needed.
document_not_containsarray<string>OptionalKeywords or phrases that must NOT be in the document title or body. Provide a list of keywords or phrases if needed.
search_only_in_shared_drive_idstringOptionalThe ID of the shared drive to restrict the search to. If provided, the search will only return documents from this drive. Defaults to None, which searches across all drives.
include_shared_drivesbooleanOptionalWhether to include documents from shared drives. Defaults to False (searches only in the user's 'My Drive').
include_organization_domain_documentsbooleanOptionalWhether to include documents from the organization's domain. This is applicable to admin users who have permissions to view organization-wide documents in a Google Workspace account. Defaults to False.
order_byarray<string>OptionalSort order. Defaults to listing the most recently modified documents first. If document_contains or document_not_contains is provided, then the order_by will be ignored.
createdTimecreatedTime descfolderfolder descmodifiedByMeTimemodifiedByMeTime descmodifiedTimemodifiedTime descnamename descname_naturalname_natural descquotaBytesUsedquotaBytesUsed descrecencyrecency descsharedWithMeTimesharedWithMeTime descstarredstarred descviewedByMeTimeviewedByMeTime desc
limitintegerOptionalThe number of documents to list
pagination_tokenstringOptionalThe pagination token to continue a previous request

Requirements

No secrets required

Output

Type:jsonDocument count, list of documents, pagination token, and has_more flag
#

GoogleDocs.WhoAmI

Get comprehensive user profile and Google Docs environment information. This tool provides detailed information about the authenticated user including their name, email, profile picture, Google Docs access permissions, and other important profile details from Google services.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:jsonGet comprehensive user profile and Google Docs environment information.
Last updated on