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

# Connections

> Import documents from Google Drive, OneDrive, and other external storage accounts.

Connections link your external storage accounts, such as Google Drive or OneDrive, to Mesa. Instead of downloading documents and re-uploading them by hand, you import them directly, and once imported, they work like any other file in Mesa.

## Set up a connection and import files

<Steps>
  <Step title="Open the Connections tab">
    Go to your Settings page and switch to the **Connections** tab. This is where you create new connections and manage existing ones.

    <Frame>
      <img src="https://mintcdn.com/calderapbc/7IoAzzCFGlCom9iV/images/Screenshot-2026-06-27-at-9.25.08-PM.png?fit=max&auto=format&n=7IoAzzCFGlCom9iV&q=85&s=f1d227cae25e8fecbe55d4168e9896dd" alt="" width="2494" height="1770" data-path="images/Screenshot-2026-06-27-at-9.25.08-PM.png" />
    </Frame>
  </Step>

  <Step title="Create and authorize the connection">
    Create a new connection and authorize Mesa to access the external account.
  </Step>

  <Step title="Import files from the connection">
    Go to the **Files** page, click **Upload**, and select your connection as the source.

    <Frame>
      <img src="https://mintcdn.com/calderapbc/7IoAzzCFGlCom9iV/images/Screenshot-2026-06-27-at-9.26.24-PM.png?fit=max&auto=format&n=7IoAzzCFGlCom9iV&q=85&s=d92a4927ea4e8e78ee15112b224ad48e" alt="" width="2494" height="1770" data-path="images/Screenshot-2026-06-27-at-9.26.24-PM.png" />
    </Frame>
  </Step>

  <Step title="Choose your documents">
    Select the files you want to bring into Mesa. Once imported, use them like any other file: organize them into folders, tag them in conversations, and share them.
  </Step>
</Steps>

## Supported file formats

Mesa imports `.docx` and `.xlsx` files from connections. From Google Drive, it also imports native **Google Workspace** documents (Docs, Sheets, Slides, and Drawings), converting them to their Office or image equivalents on the way in, so you no longer have to convert them by hand first.

<Warning>
  Google caps Workspace exports at around 10 MB. A very large Google Doc or Sheet can fail at import time; if that happens, trim it or export it manually from Drive and upload the file instead.
</Warning>

## Let the agent use a connection

Beyond importing files yourself, you can let Mesa's agent browse, search, and import files from a connection during a research conversation, so you can ask it to pull in a document by name instead of importing it first.

Agent access is **off by default** for every connection. To turn it on, open the **Connections** tab, find the connection under **Active connections**, and switch on **Agent access**.

<Frame>
  <img src="https://mintcdn.com/calderapbc/v3AUcVbc0Tld9RGw/images/connections-agent-access.png?fit=max&auto=format&n=v3AUcVbc0Tld9RGw&q=85&s=be370eccddd1a3ed31118df0bca2cf18" alt="" width="2494" height="1770" data-path="images/connections-agent-access.png" />
</Frame>

Once enabled, Mesa can reach that account when it needs a file, and any document it imports shows up inline in the conversation. Mesa only ever acts on the connections you've opted in; turn the switch back off at any time to revoke access.

## Related articles

<Card title="Files" href="/files" horizontal>
  Organize and manage documents after importing them into Mesa.
</Card>

<Card title="Tagging files" href="/tagging-files" horizontal>
  Use imported files in conversations through the `@` file picker.
</Card>

<Card title="Settings" href="/settings" horizontal>
  Find the Connections tab on your Settings page.
</Card>
