Google Drive

Connect Google Drive to your AI agent. It answers from the Docs, Sheets, PDFs and files you pick, in your helpdesk, Slack and chat, with the file linked.

eesel's AI agent for Google Drive answers questions from the Drive files and folders you pick, and links the file it used. It reads Docs, Sheets, Slides, modern Office files, PDFs and text files without changing anything in your Drive.

Your AI teammate reads the Google Drive files and folders you pick, and answers from them wherever it works. Every answer links the file it used.

The Drive files you pick become knowledge your agent answers from.

Set up eesel in Google Drive

1

Ask your agent to connect Google Drive

Open the chat in your dashboard and ask it to connect Google Drive. The sign-in has to happen in the dashboard. Your agent links the Integrations page and tells you to click Google Drive there. Prefer to click? That page has the same Connect Google Drive option.

The agent hands you the link and says what happens after you approve.

2

Sign in and grant read access

Clicking Google Drive opens a short notice. The connection is brokered by Pipedream, our integration provider, so Pipedream is named here and on Google's own screen. Click Continue.

The notice that names Pipedream as the integration provider.

Google's sign-in and consent screen comes next. It names Pipedream and lists one Drive permission whose wording covers more than reading. eesel uses it only to read the files you pick in the next step. Pick the account whose files you want read, then click Continue. Your agent never sees more than that Google account can see.

A person approves this in the browser.

3

Pick your files and folders

Back in the dashboard, the Add files from Google Drive picker opens. Search, or tick items under My Drive and Shared with me, including files in Shared Drives. Picking a folder brings in every supported file inside it, walking subfolders up to 20 levels deep. Click Add files when you are done.

The picker, with folders listed under My Drive and Shared with me.

New files never arrive on their own. Dropping a file into a folder you already picked does not pull it in, and a re-sync will not find it either. To include a new file, re-open the picker, re-select the folder or file, and sync again.

4

Confirm the connection and check what it can read

Integrations > Google Drive shows the connection as Connected, with Start a chat buttons and a Sources list of what the agent can read. Each source row has its own document count and its own toggle, and Add re-opens the picker.

Each source row has its own document count and its own toggle.

Check it worked. Each source row shows its document count once its sync is done. From a terminal, eesel status lists the integration as connected with its source counts.

5

Ask it something

Ask a question that only a Drive file can answer. Your agent answers, links the file it used and lists its sources underneath, with follow-up suggestions.

An answer built from a Drive document, with the source file linked.

6

Tell it how to answer

Tell your agent a standing rule in plain language. It shows you the exact wording it wants to save and asks you to confirm before it writes anything.

The agent shows the wording it will save, then asks you to confirm.

The saved rule lives on the Instructions page, where you can read it and edit it by hand.

The rule on the Instructions page, ready to edit.

7

Use it where your team works

A teammate can mention your agent in Slack and get the answer in the thread. The source file is linked, and any rule you saved is applied.

The same answer in a Slack thread, with the source linked.

From Claude Code, Cursor or a terminal. The same setup works as commands: eesel login, then eesel integrations connect google_drive, which prints the details it needs, including the sign-in link for a person to open. The approval is a human step: print the link for a person, wait for the connection status to change, and do not retry the link. Then eesel integrations download start copies your files in, eesel status shows the integration as connected with its source counts, and eesel chat asks it a question. Picking files and folders has no command, so use the dashboard chat for that step. Full command reference: The eesel CLI. Step-by-step: Set up from Claude Code or the terminal. From an MCP client: Claude Code and MCP clients.

Sources

On the integration page the files you pick are grouped into source rows, each with its own count and toggle. This is what each row can hold:

Source	Description	Requires
Google Docs	The full text of your documents	The file selected in the picker
Google Sheets	Spreadsheet data, across every tab in the sheet	As above
Google Slides	The text content of your presentations	As above
Office files	Word (.docx), Excel (.xlsx) and PowerPoint (.pptx)	As above
PDFs	PDF files stored in Drive	As above
Text files	Text-based files such as .txt, .md, .csv, .html, JSON and XML	As above
Folders	Every supported file inside a folder you select, and its subfolders	The folder selected in the picker

What gets skipped. Images, video and audio, Google Forms, Google Maps, Google Sites, and Drive shortcuts. Files in the trash and files over 50 MB are skipped too. Legacy Office formats (.doc, .xls, .ppt) are not supported, so re-save those as the modern format or as a Google Doc. In a folder, the supported files sync and the rest are ignored.

Daily limit. A workspace can sync up to 2,500 files a day. A sync that would go past the cap stops with a daily limit message, rather than syncing a partial batch. The counter resets each day, so run the sync again the next day, or get in touch to have the limit raised.

How updates get picked up. There is no automatic re-sync on a schedule. Trigger a re-sync from the integration settings, or ask your agent to. A re-sync only refreshes files that are already indexed. It picks up edits, drops files you deleted in Drive, and updates renamed files to match. It never finds new files. That takes re-selecting them in the picker.

Every other integration on the agent is also a source, so a Drive answer can draw on Confluence, Notion, your helpdesk and your website at once. See Integrations.

You stay in control the whole way. Adjust your AI agent's access to knowledge to your liking.

Limitations

• New files never arrive on their own. A file added to a folder you already picked needs re-selecting in the picker.

• No scheduled re-sync. Content refreshes only when you or your agent trigger a re-sync.

• Up to 2,500 files a day per workspace. A sync that would pass the cap stops with a daily limit message.

• Some files are skipped. Files over 50 MB, legacy .doc, .xls and .ppt files, images, video, audio, Google Forms, Maps, Sites and shortcuts.

• Read-only. Google Drive has no triggers and no actions.

Troubleshooting

A file is not being answered from?

If you added the file recently, re-select it in the picker. Otherwise check that the file is a supported type and under 50 MB, that it is owned by or shared with the connected Google account, that it is not in the trash, and that it is not nested more than 20 folder levels below the folder you picked.

Answers are out of date?

Nothing refreshes on a schedule. Trigger a re-sync from the integration settings. It only refreshes files that were already indexed, so a file that never synced will not appear.

Sync stopped with a daily limit message?

Run the sync again the next day, or get in touch to have the 2,500-file daily limit raised.

Connection expired or showing a legacy warning?

Google access can expire or be revoked. Disconnect and reconnect to refresh it. The same fix moves a legacy connection onto the current integration.

FAQ

How do I add an AI agent to Google Drive?

Connect Google Drive to eesel, pick the files and folders you want, and your eesel agent answers from them. Ask it in the dashboard chat to connect Google Drive, sign in with Google, then choose files in the picker. See Set up eesel in Google Drive.

Can I connect Google Drive to ChatGPT or Claude?

Yes, through eesel. Once Google Drive is connected, you can talk to your eesel agent from Claude, ChatGPT or Cursor, and it answers from your Drive files. See Use eesel from Claude and other assistants, Use eesel from ChatGPT and Claude Code and MCP clients.

Which Google Drive file types can my agent read?

Google Docs, Sheets and Slides, modern Word, Excel and PowerPoint files (.docx, .xlsx, .pptx), PDFs, and text-based files such as .txt, .md, .csv, .html, JSON and XML. Images, video, audio, Google Forms, Maps, Sites and shortcuts are skipped, and so are legacy .doc, .xls and .ppt files.

Can my agent change anything in my Google Drive?

No. The integration is read-only and exposes no actions at all. Your agent reads the files you picked and can never edit, move, rename or delete anything in your Drive.

Why is my agent not answering from a file I added to Google Drive today?

New files are not picked up on their own, even inside a folder you already synced. A re-sync only refreshes files that are already indexed. Re-open the picker, re-select the folder or file, and sync again.

What happens if I delete or rename a file in Google Drive?

Both are reconciled on the next re-sync. A deleted file is dropped from your agent's knowledge, and a renamed file is updated to match.

Does Google Drive re-sync on its own?

No. Content refreshes when you trigger a re-sync from the integration settings, or when you ask your agent to.

Related pages

• Internal operations

• Integrations overview

• Set up from Claude Code or the terminal