Google Drive
Connect Google Drive to ORQO so that agents can list, search, read, and create files in your Google Drive through MCP tools.
| Category | Storage |
| Capabilities | MCP tools only (no send/receive channel) |
| Adapter path | /google_drive |
| Auth method | OAuth 2.0 |
Google Drive is an MCP-only integration. It provides tools for agents to interact with Google Drive programmatically, but does not support inbound/outbound messaging through Doorkeeper or channels.
Prerequisites
- A Google account with Google Drive access
- A Google Cloud project with the Drive API enabled
- OAuth 2.0 credentials (client ID and client secret) configured in the Google Cloud Console
- Access to the ORQO Settings area
Setup
1. Set Up Google Cloud Credentials
- Go to the Google Cloud Console.
- Create a project (or select an existing one).
- Enable the Google Drive API under APIs & Services > Library.
- Navigate to APIs & Services > Credentials and create OAuth 2.0 Client ID credentials.
- Set the redirect URI to the OAuth Callback URL shown on the app's detail card in ORQO.
- Note the client ID and client secret.
2. Install the Google Drive App in ORQO
- Navigate to Settings > Apps in ORQO.
- Find Google Drive in the app catalog and click Install.
- The app is created with the correct adapter URL and capabilities.
3. Add Credentials
After installation, the credentials checklist shows what's required:
| Credential | Type | Description |
|---|---|---|
| GOOGLE_OAUTH2 | oauth2 | OAuth 2.0 credentials (client ID, client secret, tokens) |
Create the credential in Settings > Credentials, then assign it to the Google Drive App. Use the OAuth flow to authorize ORQO with Google.
4. Authorize via OAuth
- Click the Authorize button on the Google Drive app card in ORQO.
- You are redirected to Google's consent screen.
- Select the Google account and approve the requested permissions.
- ORQO stores the tokens and refreshes them automatically.
5. Verify the Connection
Click Verify on the Google Drive app card in ORQO. This tests the connection to the adapter and discovers the available MCP tools.
Available Tools
The Google Drive adapter exposes MCP tools that agents can use in workflows:
| Tool | Description |
|---|---|
google_drive_list_files | List files and folders in Google Drive |
google_drive_search | Search for files by name, type, or content |
google_drive_read_file | Read the contents of a file |
google_drive_create_file | Create a new file in Google Drive |
google_drive_create_folder | Create a new folder in Google Drive |
google_drive_import_to_documents | Import a Google Drive file into ORQO's document library |
These tools are discovered automatically when the App is verified and can be assigned to agents via Skills.
Platform-Specific Behavior
- OAuth 2.0 — Full OAuth authorization flow with automatic token refresh.
- Import to Documents — The
google_drive_import_to_documentstool lets agents pull files from Google Drive directly into an ORQO project's document library, where they are classified and indexed by the Knowledge Curator. - No channel capabilities — Google Drive does not support send/receive channels. It is a tool-only integration for programmatic file access.
What's Next
- Connect Document Sources to auto-sync Google Drive folders into the knowledge graph
- Apps & Channels for the full architecture
- Create a Skill to bundle Google Drive tools for agents
- Manage Documents to learn about ORQO's document library