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

# Google Drive Integration

> Add files from Google Drive to a deal or account so Minoa can use them as context

Minoa integrates with Google Drive so you can add the files that already live in Drive — proposals, pricing sheets, security answers, notes — and have Minoa use them when answering questions on a deal.

Google only asks for access to the files you pick. The rest of your Drive stays private.

***

## How It Works

You add files from the **Context** tab on a deal or an account.

* **Deal files** — visible only on that deal. You need edit access on the deal.
* **Account files** — used on every deal with that customer. Only an admin or the account owner can add them.

If a file is already on the account, you cannot add it again on a deal — the deal already reads it.

Once a file is **In use**, Minoa uses it the same way it uses [call transcripts and notes](/pages/business-case/deal-context).

***

## Adding Files from Google Drive

### On a Deal

<Steps>
  <Step title="Open the Context tab">Open the deal and go to the **Context** tab.</Step>
  <Step title="Click Add from Google Drive">Google opens a picker titled **Choose files for Minoa to read**. Pick one file or several.</Step>
  <Step title="Grant access">Google asks once for the files you picked. Approve the request.</Step>

  <Step title="Wait until the file is In use">
    The row starts as **Reading**. When it flips to **In use**, Minoa can use it in answers.
  </Step>
</Steps>

<Check>File added. Minoa is reading it now.</Check>

### On an Account

1. Open the account and go to the **Context** tab.
2. Click **Add from Google Drive** and pick the files.
3. Every deal on that account can read them. You do not add them again per deal.

<Warning>Pick a file, not a folder. Minoa cannot read a folder as a whole.</Warning>

### Limits

| File type                                   | Limit           |
| ------------------------------------------- | --------------- |
| **Google Sheets**                           | First tab only  |
| **Uploaded files** (PDF, DOCX, and similar) | 25 MB each      |
| **Google Docs**                             | No length limit |

***

## File Status

| Status            | Meaning                                                                                     |
| ----------------- | ------------------------------------------------------------------------------------------- |
| **Reading**       | Minoa is opening the file. Larger PDFs take longer.                                         |
| **In use**        | Ready. Minoa uses it when answering questions on this deal.                                 |
| **Couldn't read** | Something went wrong. Remove the file and add it again.                                     |
| **Lost access**   | The file was deleted or unshared in Drive. Re-share it and add it again, or remove the row. |
| **Unsupported**   | We cannot read this type yet. Use a Doc, Sheet, Slide, PDF, or Word file.                   |

***

## Removing Files

1. Click **Remove** on the file row.
2. Confirm **Stop using**.

Minoa stops using the file in answers. The file itself stays in Google Drive, untouched.

<Note>
  Minoa may still appear on the file's share list in Drive. Removing a file in Minoa stops us using it — it does not
  revoke the Viewer added when you picked the file.
</Note>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="I don't see Add from Google Drive">
    You need edit access on the deal (or admin / account-owner access to add files for the whole account). If you
    have that and still don't see the button, contact [support@minoa.io](mailto:support@minoa.io).
  </Accordion>

  <Accordion title="Google's sign-in window never appears">
    Your browser blocked the pop-up. Allow pop-ups for `app.minoa.io`, then try again.
  </Accordion>

  <Accordion title="Google wouldn't give Minoa access to that file">
    You may not have permission to share the file. Ask the owner to share it with you, then add it again.
  </Accordion>

  <Accordion title="I can't add a file that is already on the account">
    Account-level files are already available on every deal. You do not add them again on the deal.
  </Accordion>
</AccordionGroup>

***

## Security & Permissions

When you pick a file, Minoa adds a Viewer on **that file only**:

`minoa-google-drive@minoa-roi-firebase.iam.gserviceaccount.com`

* No domain-wide delegation
* No "anyone with the link"
* No access to folders, Shared Drives as a whole, or files you did not pick

Google's picker is the consent screen. If IT reviews Drive sharing, they will see that Viewer on the files sellers choose to add.

***

## Key Takeaways

* Add files from the **Context** tab with **Add from Google Drive**
* Google only grants the files you pick
* **In use** means Minoa can read the file; **Reading** means wait
* Account-level files apply to every deal on that customer; deal-level files stay on that deal
* Removing a file stops Minoa using it. The Drive file is untouched
* Minoa requests Viewer on picked files only — no domain-wide access

Learn more about deal context in [Deal Context](/pages/business-case/deal-context).