--- title: Google Docs summary: Connect a Google Docs account so your AI agents can find, read, draft, and edit documents under permissions you control. category: integrations slug: googledocs --- ## What Google Docs in Kronos lets your agents do Once a Google Docs account is connected to Kronos, your agents can — within the permissions you grant — work with your documents the way you would in Google Docs: **Read actions** (available when an agent has "Read only" or higher): - Search for documents by title or content. - Open a document and read its full text, structure, and formatting. - List the charts embedded in a linked spreadsheet, and read a specific chart. **Write actions** (available only when an agent has "Read and write"): - Create a new document, including one built from text or Markdown you provide. - Make a copy of an existing document. - Insert text, page breaks, images, tables, headers, footers, and footnotes. - Replace text throughout a document, or replace an image. - Update a document's content, style, and table formatting. - Add or remove bullet lists and named ranges. - Delete content, tables, table rows or columns, headers, footers, or named ranges. You decide which agent gets which level, and you can switch any permission off in one click without disconnecting the Google Docs account. ## Connecting Google Docs 1. Open Kronos → **Connect** in the sidebar → **Applications** tab. 2. Click the **Google Docs** card to open the detail dialog, then click the green **Connect** button. 3. You land on Google's screen — pick the Google account you want to connect. 4. Confirm the chosen account on Google's summary screen. 5. Review the access Kronos is requesting (read and edit your documents) and continue. Leave the access checked — some actions stop working if you uncheck a category. 6. You're sent back to Kronos at the **Already connected** tab with the new Google Docs entry pre-selected. You can connect more than one Google account, and each appears as its own connection. ## Naming the connection The Google Docs management page shows the connection with an optional **Your note for this connection** field. Because documents live inside a Google account rather than under a single account label, the note is the clearest way to tell connections apart — give each one a short label like "Company Drive", "Marketing", or "Legal" so a long list stays scannable. The note is yours only; it does not change what the agent can access. ## Giving an agent access On the management page click **+ Add AI Agent**, pick the agent from the dropdown, then choose: - **Off** — the agent cannot touch this Google Docs account. - **Read only** — the agent can search, open, and read documents, but cannot create, edit, or delete anything. - **Read and write** — the agent can do all of the above plus create documents, insert and replace text, format content, manage tables and images, and delete content. The same controls are available inside the AI Agent editor — scroll to the **Connected Apps** section. ## Fine-grained overrides Inside the permissions modal (the gear icon next to a Google Docs account in the agent editor or on the management page) you'll see the full list of actions grouped by **Read tools** and **Write tools**. Toggle individual actions on or off to override the preset. Common combinations: - **Research assistant**: preset Read only, no overrides. The agent finds and summarizes documents but changes nothing. - **Drafting agent**: preset Read only, override `Create a document` and `Insert Text into Document` ON. The agent can read your existing documents and draft new ones, but cannot delete content from them. - **Editor agent**: preset Read and write, overrides `Delete Content Range in Document` and `Delete Table` OFF. The agent can draft, insert text, and reformat, but cannot remove existing content. - **Full assistant**: preset Read and write, no overrides. Click Save to apply. Changes take effect on the next message the agent processes. ## Multiple Google Docs accounts on the same agent If an agent has access to two or more Google Docs accounts (e.g. Work + Personal), the agent picks which account to use on every action based on context. When the request is ambiguous ("draft a memo"), the agent will ask which account to use. You can cut ambiguity by turning the agent's access to one of the accounts off, or by giving the connections obviously distinct notes ("Work Docs" vs "Personal Docs"). ## When something goes wrong - **"Needs reconnect"** badge — Google revoked or expired the connection. Open `/app/connect`, click Google Docs, and walk through Connect again. Permissions are preserved. - **Agent says "I can't create that document"** — that agent's permission preset is Off or Read only without the matching write override. Open the permissions modal and adjust. - **Agent says it can't find a document** — the document may belong to a Google account other than the connected one, or the title didn't match. Ask the agent to search by a different term, or confirm the document is visible to the connected account. - **Agent says the connected app is temporarily unavailable** — Google or the connection had a transient hiccup. Ask the user to retry in a moment. If it persists, check the management page for a "Needs reconnect" badge. ## Privacy Kronos does NOT store the content of your Google Docs documents. Each time an agent uses a Docs action, it fetches just-in-time through the connection, uses what it needs to complete the task, and discards the result. The audit log records that the action happened (which agent, which action, when, and whether it succeeded), but not the document contents. When you disconnect Google Docs or cancel your Kronos subscription, the connection and all per-agent permissions are deleted immediately.