> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digcrate.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Docs

> Save research as shareable Google Docs with one click

Connect Google to save research as a formatted document in your Google Drive. The agent creates the doc, inserts the content, and returns a shareable link — no copying and pasting required.

<Note>
  Digcrate uses Auth0 Token Vault for the Google connection. Your Google credentials and raw access tokens are never stored by Digcrate — Auth0 handles the token exchange at runtime.
</Note>

## What you can do

<CardGroup cols={2}>
  <Card title="Save research as a Google Doc" icon="file-text">
    Any research output can be saved as a new document in your Google Drive with a title you provide.
  </Card>

  <Card title="Get a shareable link" icon="link">
    The agent returns a direct `docs.google.com` link as soon as the document is created.
  </Card>
</CardGroup>

## How to connect

<Steps>
  <Step title="Open Settings">
    Click the gear icon in the sidebar, or press `Shift+S`.
  </Step>

  <Step title="Go to Connected Services">
    Select the **Connected Services** tab.
  </Step>

  <Step title="Click Connect next to Google">
    An OAuth popup opens and redirects you to Google's authorization page.
  </Step>

  <Step title="Authorize Digcrate">
    Review the permissions and click **Allow**. You are returned to Digcrate automatically.
  </Step>
</Steps>

## Permissions requested

| Scope        | What it allows                                 |
| ------------ | ---------------------------------------------- |
| `documents`  | Create and edit Google Docs                    |
| `drive.file` | Access files created by Digcrate in your Drive |

<Note>
  The `drive.file` scope gives Digcrate access only to documents it creates — not your entire Drive.
</Note>

## How to save research to Google Docs

You can save a doc in two ways:

**Ask the agent directly** — After any research response, say "save this to Google Docs" or "save this as a doc called \[title]". The agent creates the document and returns the link.

**Use the action button** — Some research components include a **Save to Google Docs** button. Clicking it triggers the same flow and returns a link when done.

<Tip>
  Give the document a descriptive title in your request — for example, "save this as 'Flying Lotus Influence Chain'". The title becomes the document's name in your Drive and is easier to find later.
</Tip>

## What gets saved

The agent passes the research content as plain text to the Google Docs API, which inserts it at the start of the document. The document is created in your Drive root folder. You can move it, share it, or edit it like any other Google Doc after it is created.

The agent returns:

* A direct link to the document (`docs.google.com/document/d/...`)
* The document title
* Confirmation that the save succeeded