Google Docs
Service domainDOCUMENTS
Arcade Optimized
Arcade.dev LLM tools for Google Docs
13tools
13require secrets
Google Docs Toolkit
The Google Docs toolkit connects Arcade to Google Docs (and Google Drive) via the Google API, enabling LLMs to create, read, edit, search, and comment on documents owned by or shared with the connected account.
Capabilities
- Document creation: Create blank documents or documents pre-populated with plain text or Markdown (headings, bold, italic, lists) in the connected account's Drive root.
- Reading and retrieval: Fetch documents as raw API resources, as compact DocMD (block IDs, character indices, style metadata), or as metadata-only (title, ID, URL, tab hierarchy, character counts). Retrieve all tabs or a specific tab.
- Editing: Apply structured
batchUpdaterequests to a document; use DocMD indices from a read call to construct precise edits. Append text to the end of any accessible tab. - Search: Query accessible Drive documents by keyword; returns metadata or metadata plus body content. Trash is excluded automatically.
- Comments: Post whole-document comments as the connected account and list existing comments with replies, authors, anchor quotes, resolution status, and pagination.
- Access management and identity: Generate a Google Drive file picker URL so the user can grant per-file access when a document is not reachable; confirm the connected account's profile (name, email, picture) before acting.
OAuth
Authentication uses OAuth 2.0 with Google as the provider. See the Arcade Google auth provider docs for setup details, required scopes, and configuration.
Secrets
ENABLE_GOOGLE_DRIVE_INLINE_PICKER_URL— Controls whether theGenerateGoogleFilePickerUrltool can return a Google Drive inline file picker URL. This is not a standard Google-issued credential; it is an Arcade-side feature flag or configuration value. Set it in the Arcade secrets dashboard. Consult the Arcade tool secrets guide for how to define and inject secrets into your toolkit configuration.
Available tools(13)
13 of 13 tools
Operations
Behavior
| Tool name | Description | Secrets | |
|---|---|---|---|
Comment on a specific document by its ID.
Reaches only documents this app has been granted edit access to — by default,
those it created or the user picked.
The comment is posted as the connected account and notifies the document's
collaborators.
The comment covers the whole document. No API can anchor a new Google Docs comment to a
passage, so the Docs UI lists it in the sidebar without highlighting any text. Quote the
passage inside comment_text when the comment is about one. | 1 | ||
Create an empty Google Docs document with the specified title.
The document is owned by the connected account and lands in its Drive root. Returns
the new document's id, which every other tool here takes as its target. To create a
document that already has content, use the tool that takes text rather than creating
an empty one and appending to it. | 1 | ||
Create a Google Docs document with the specified title and text content.
When input_format is MARKDOWN, the text_content is parsed as Markdown and the resulting
document is formatted with headings, bold, italic, bullet lists, and numbered lists. | 1 | ||
Read or edit a Google Docs document using structured batchUpdate requests.
Reaches only documents this app has been granted edit access to — by default,
those it created or the user picked.
When called without requests, returns the document content in DocMD format (block IDs,
character indices, and text styles). When called with requests, applies the edits and
returns the updated DocMD. Use the DocMD indices from the response to construct
requests for subsequent calls. | 1 | ||
Generate a URL where the user can grant this app access to specific Drive files.
Check `url` first. An empty `url` with a `reason` means this app already reaches every
document the connected account can open, so there is no per-file grant to request: this
tool cannot change any outcome, and a document that could not be read is one the
account itself cannot open. Do not retry it.
Otherwise the URL opens Google's first-party Drive picker, where the user selects which
files to share with this application — it is not a sign-in or credential prompt. Use
this when a prior tool reported that a file was not found or access was denied, and the
user expects the file to exist. After the user completes the picker flow, retry the
prior tool. | 1 | ||
Get the latest version of the specified Google Docs document as DocMD.
Reaches only documents this app has been granted access to — by default, those it
created or the user picked.
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. | 1 | ||
Get a Google Docs document as the raw Google Docs API document resource.
Returns the API's own structure, including every tab's content. Reaches only
documents this app has been granted access to — by default, those it created or the
user picked. Use this when the document's exact structure matters, such as reading
style runs, named ranges or inline object properties. For reading or summarizing the
text, prefer the DocMD form, which is far smaller and carries the character indices
edits are built from. | 1 | ||
Get metadata for a Google Docs document including hierarchical tab structure.
Reaches only documents this app has been granted access to — by default, those it
created or the user picked.
Returns document title, ID, URL, total character count, and nested tab information
with character counts for each tab. | 1 | ||
Appends text to the end of a Google Docs document.
Reaches only documents this app has been granted edit access to — by default,
those it created or the user picked.
Each tab keeps its own content and its own character indices, so the text lands at the
end of one tab rather than the end of the file. | 1 | ||
List comments on the specified Google Docs document.
Reaches only documents this app has been granted access to — by default, those it
created or the user picked.
Returns each comment's text, its replies, and the display name of whoever wrote it.
Drive does not document an order for comments, so do not read the first one as the
most recent; compare createdTime when recency matters. A long-running document can
carry thousands of comments, so results are paged rather than returned whole, and the
counts describe the page in hand rather than the document.
A comment anchored in the Docs UI carries quotedFileContent, the passage it is attached
to, so finding that text in the document body places the comment. A comment that covers
the whole document has no quotedFileContent. Each comment also reports whether its thread
has been resolved. | 1 | ||
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.
Searches only the documents this app has been granted access to — by default, those
it created or the user picked.
Content it returns was written by whoever has edited each document, which need not be
the connected account and need not be the owner.
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. | 1 | ||
Searches for documents in the user's Google Drive. Excludes documents in trash.
Searches only the documents this app has been granted access to — by default, those
it created or the user picked.
Returns metadata only. Use get_document_metadata or get_document_as_docmd for content. | 1 | ||
Get the connected Google account's profile: name, email address and profile picture.
Use this to confirm which account the connection is acting as before creating or
editing a document, or when the user asks who they are signed in as.
It reads the Google profile and opens no document, so it does not report which
documents this app can reach. To find out whether a particular document is reachable,
search for it or open it. Fields Google does not return are omitted rather than empty. | 1 |
Last updated on