|
| 1 | +# Google Drive Integration |
| 2 | + |
| 3 | +Connect your Google Drive to agentic sessions so Claude can read and write files in your Drive. |
| 4 | + |
| 5 | +## What It Does |
| 6 | + |
| 7 | +Once connected, Claude can: |
| 8 | +- List files and folders in your Google Drive |
| 9 | +- Read file contents |
| 10 | +- Create new files |
| 11 | +- Update existing files |
| 12 | +- Search your Drive |
| 13 | + |
| 14 | +## How to Use |
| 15 | + |
| 16 | +### 1. Connect Google Drive to a Session |
| 17 | + |
| 18 | +1. Open or create an agentic session |
| 19 | +2. In the left sidebar, expand **"MCP Integrations"** |
| 20 | +3. Click **"Connect"** on the Google Drive card |
| 21 | +4. Authorize in the popup window |
| 22 | +5. Close the popup when you see "Authorization Successful" |
| 23 | + |
| 24 | +### 2. Use Drive in Your Prompts |
| 25 | + |
| 26 | +Once connected, you can ask Claude things like: |
| 27 | + |
| 28 | +- "List the files in my Google Drive" |
| 29 | +- "Read the contents of 'meeting-notes.txt' from my Drive" |
| 30 | +- "Create a new document in my Drive called 'project-summary.md' with this content..." |
| 31 | +- "Find all PDFs in my Drive from last month" |
| 32 | + |
| 33 | +### 3. Disconnect (Optional) |
| 34 | + |
| 35 | +Credentials are automatically removed when the session ends. To disconnect earlier, click "Disconnect" in the MCP Integrations accordion. |
| 36 | + |
| 37 | +## First-Time Setup (Admin) |
| 38 | + |
| 39 | +Administrators need to configure Google OAuth credentials once: |
| 40 | + |
| 41 | +1. Create a Google Cloud project and OAuth 2.0 credentials |
| 42 | +2. Set authorized redirect URI to: `https://your-vteam-backend/oauth2callback` |
| 43 | +3. Create a Kubernetes Secret in the operator namespace: |
| 44 | + |
| 45 | +```bash |
| 46 | +kubectl create secret generic google-workflow-app-secret \ |
| 47 | + --from-literal=GOOGLE_OAUTH_CLIENT_ID='your-client-id' \ |
| 48 | + --from-literal=GOOGLE_OAUTH_CLIENT_SECRET='your-client-secret' |
| 49 | +``` |
| 50 | + |
| 51 | +## Security & Privacy |
| 52 | + |
| 53 | +- **Session-scoped**: Credentials only exist for the current session |
| 54 | +- **Automatic cleanup**: Credentials deleted when session ends |
| 55 | +- **No sharing**: Your credentials never accessible to other users or sessions |
| 56 | +- **You control access**: You must explicitly connect for each session |
| 57 | + |
| 58 | +## Troubleshooting |
| 59 | + |
| 60 | +**"Connect" button doesn't work** |
| 61 | +- Check that popup blockers aren't blocking the OAuth window |
| 62 | + |
| 63 | +**Claude says it can't access Drive** |
| 64 | +- Verify you see "Connected" status in MCP Integrations accordion |
| 65 | +- Try disconnecting and reconnecting |
| 66 | +- Check the session logs for errors |
| 67 | + |
| 68 | +**"Invalid scopes" error** |
| 69 | +- You may need to re-authorize with updated permissions |
| 70 | +- Click "Disconnect" then "Connect" again |
| 71 | + |
| 72 | +## Questions? |
| 73 | + |
| 74 | +See the [workspace-mcp documentation](https://github.com/taylorwilsdon/google_workspace_mcp) for details about what Drive operations are supported. |
0 commit comments