Google Docs
Read and edit the content of Google Docs.
Connect a Google account to work with any document's content: read it as plain text, map its structure with Outline, and make surgical edits by index - insert, append, delete ranges, replace text, tables and images. Find text supplies the real indexes every edit takes; nothing is ever guessed. Reaches any document the signed-in account can access, by id or pasted URL. Creating, finding, exporting and sharing documents are the Google Drive integration's job.
Connect
Sign in with Google. Sign in with Google to read and edit your documents. An organization admin configures the OAuth app once under Integrations → OAuth apps; after that, connecting is a consent screen.
-
Connecting signs in as YOU - reading and editing reach exactly the documents your Google account can access, by id or pasted URL, with no sharing step.
-
This connection asks for Docs access only - no Drive access of any kind. Creating, finding, exporting and sharing documents live in the Google Drive integration.
Tools
| Tool | Access | What it does |
|---|---|---|
Read document (yekar.google-docs.read) | Read | Read a document's content as plain text - works on ANY document the signed-in account can access, by id or pasted URL. Long documents are paged, never silently cut: the result reports totalChars and a nextOffset to continue from. (For a PDF/Word/markdown rendering of a generated document, use the Google Drive integration's export.) |
Outline document (yekar.google-docs.outline) | Read | Structure of a document without its full text: tabs, headings, tables and named ranges, each with the index range the edit tools take. Call this to navigate a long document instead of reading all of it. |
Find text (yekar.google-docs.find-text) | Read | Locate text in a document and return each match's index range plus surrounding context. This is how you get the indexes that Insert text and Delete range need - never guess one. |
Replace text (yekar.google-docs.replace-all-text) | Write | Replace every occurrence of one or more placeholders throughout a document (all tabs, headers and footers included). Needs no indexes and is idempotent - a second run finds nothing left to replace - which makes it the safest way to fill a template. |
Append text (yekar.google-docs.append) | Write | Add plain text to the end of a document. Text is inserted literally - for formatted content write markdown with Replace document body instead. NOT idempotent: a retried append adds the text twice, so after an interruption the run fails rather than duplicate it. |
Insert text (yekar.google-docs.insert-text) | Write | Insert plain text at a document index, or anchored immediately before/after existing text. NOT idempotent: a retried insert adds the text twice. |
Delete range (yekar.google-docs.delete-range) | Write | Delete the content between two document indexes. Get the indexes from Find text - never guess them. NOT idempotent: every deletion shifts everything after it, so re-running the same range removes DIFFERENT content. |
Insert table (yekar.google-docs.insert-table) | Write | Insert an empty table of the given size. Fill its cells afterwards with Insert text using the indexes from Outline - a fresh table's cells are empty paragraphs. NOT idempotent: a retried call inserts a second table. |
Insert image (yekar.google-docs.insert-image) | Write | Insert an image from a public https URL at a document index. The URL must be reachable by Google's servers - private or signed-once URLs will fail. NOT idempotent: a retried call inserts a second copy. |
Batch update (raw) (yekar.google-docs.batch-update) | Write | Send raw Google Docs API batchUpdate requests - the escape hatch for the ~40 operations this integration does not wrap (text and paragraph styling, bullets, headers/footers, named ranges, section breaks, table cell styling, suggestions). Requests apply in order and every earlier one shifts the indexes of the later ones. Prefer the dedicated tools where they exist. |
Notes
- Sign in with Google to connect - tools act as your Google account and read or edit exactly the documents you can.
- Never guess a document index: call Find text or Outline to get real ones, then pass them to Insert text or Delete range.
- Append and Insert text write LITERAL text - there is no markdown conversion here. To generate a formatted document from markdown, use the Google Drive integration.
- For a document the user mentions, ask for its link - read and edits take a pasted docs.google.com URL directly.