# Connect Google Drive for Workspaces to AI coding agents with Unblocked

URL: https://getunblocked.com/integrations/google-drive-for-workspaces/

The Unblocked Google Drive for Workspaces integration connects your organization’s entire Workspace Drive in a single administrator setup, then answers questions from it with document-permission awareness and citations back to the source file.

---

## Google Drive for Workspaces integration details

- **Category:** Knowledge
- **Indexed data:** Google Docs, Google Sheets, Google Slides, text files, PDFs, shared drives, personal drives, users, groups, and content permissions
- **Supported products:** Google Workspace organizations
- **Works with:** Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, OpenCode, VS Code — via one MCP server connection
- **Content reviewed:** July 20, 2026
- **Documentation:** <https://docs.getunblocked.com/data-sources/google-drive-for-workspaces>
- **Website:** <https://workspace.google.com/products/drive/>

## What the Google Drive for Workspaces integration adds

The documents that explain your systems — architecture proposals, PRDs, launch plans, runbooks, postmortems — are usually spread across an entire Google Workspace rather than one person’s Drive. Google Drive for Workspaces connects that Workspace as a whole, so coverage does not depend on who remembered to share a folder.

Where the individual Google Drive integration indexes the files one connecting user selects, this integration is set up once by a Google administrator against your Workspace: choose all current and future content in the organization, or scope it down to specific files, folders, and drives.

Because Unblocked reads the permission structure of each document from your Workspace, it understands who can see what without asking every developer to link a Google account. With Data Shield enabled, people can also ask about their own personal Drive content, and every answer stays inside the permissions the document already has.

Through the Unblocked MCP integration, this Workspace context is available to Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, VS Code, and other compatible AI coding tools, reconciled with your code, pull requests, tickets, and conversations.

### What you get

- **Organization-wide content scope** — Select all current and future content in your Workspace so newly created documents are picked up without anyone re-sharing a folder, or narrow the scope to specific files, folders, and drives.
- **Identity-aware answers** — Unblocked understands the permission structure of each document from your Workspace, so answers respect existing access without every individual user linking their own Google account.
- **Personal Drive content** — With Data Shield enabled, developers can ask about documents in their own personal Drive alongside shared organizational content.
- **Sync that keeps up with your team** — New and updated files are picked up every 15 minutes, and users, groups, and content permissions sync every hour so access changes are reflected in Data Shield within the hour.
- **One administrator setup** — A Google Super Admin connects the Workspace once through a service account and domain-wide delegation — no per-developer authorization to chase.
- **Cross-source synthesis** — Workspace documents are combined with your code, pull requests, Jira tickets, and Slack threads into a single knowledge graph.

## How to connect Google Drive for Workspaces to Unblocked

Prerequisites:

- An Unblocked account (free to start).
- A Google Super Admin in your organization to complete the setup, or an account holding a delegated custom admin role with read access to users, groups, and organizational units.
- Permission to create a Google Cloud project, a service account key, and a domain-wide delegation client for your Workspace.
- An MCP-compatible coding agent (Claude Code, Cursor, Windsurf, etc.) to use the context in your editor.

### Step 1: Connect Google Drive for Workspaces to Unblocked

1. In Unblocked, go to Settings → Data Sources → Connect another data source, and under Documentation select Google Drive for Workspaces.
2. In the Google Cloud Console, create a project whose domain matches your organization, then paste its Project ID into the Unblocked form to reveal the remaining steps.
3. Enable each Google API that Unblocked links to for that project, so it can process Drive content and sync user permissions.
4. Create a service account, add a JSON key, and paste the contents of the downloaded key into the Private Key field in Unblocked.
5. In Domain-wide Delegation, add a new API client using the key’s client_id and the OAuth scopes Unblocked provides.
6. Enter a Super Admin email — or the account holding your custom admin role — and click Validate Connection.
7. Choose all Workspace content or specific files, folders, and drives, then click Save Settings.

See the complete setup guide, screenshots, and troubleshooting: <https://docs.getunblocked.com/data-sources/google-drive-for-workspaces>

If Google blocks service account key creation, override the iam.disableServiceAccountKeyCreation organization policy to Not enforced and retry; the override can take a few minutes to take effect.

A newly assigned custom admin role can also take a few minutes to propagate before Validate Connection succeeds.

### Step 2: Install the Unblocked MCP server

On macOS or Linux, one command auto-detects and configures your supported agents (Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, OpenCode, VS Code):

```bash
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
```

On Windows, or when you prefer remote MCP, add the server manually using the configuration below or follow the manual install guide: <https://docs.getunblocked.com/unblocked-mcp/mcp-overview>

Claude Code — add the remote server, then run /mcp in Claude Code, select unblocked, and log in via OAuth:

```bash
claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse
```

Cursor — open View: Open MCP Settings → Add Custom MCP, add the server, then click Connect to authenticate via OAuth:

```json
{
  "mcpServers": {
    "unblocked": {
      "url": "https://getunblocked.com/api/mcpsse"
    }
  }
}
```

Any MCP-compatible client (Windsurf, Codex, VS Code, Claude Desktop, and others) can connect to the remote server with OAuth: `https://getunblocked.com/api/mcpsse`

## Connect Google Drive for Workspaces to Claude Code, Cursor, and other AI agents

To give Claude Code, Cursor, GitHub Copilot, Codex, or another MCP-compatible AI coding agent access to Google Drive for Workspaces context, connect Google Drive for Workspaces to Unblocked and add the single Unblocked MCP server to your agent.

Unblocked acts as the MCP context layer for your Google Drive for Workspaces data, searching Google Docs, Google Sheets, Google Slides, text files, PDFs, shared drives, personal drives, users, groups, and content permissions alongside your other connected sources and returning cited results through these tools:

- **`context_research`** — Multi-source research across your Workspace’s Drive content, plus your code, pull requests, and other connected sources. Returns a synthesized answer with citations back to the document it used.
- **`context_get_urls`** — Fetches the full content behind a Google Drive document URL your agent encounters — plus GitHub, Jira, Linear, Confluence, Slack, and more.

## Questions to ask an AI agent about Google Drive for Workspaces

Questions you (or your agent) can ask Unblocked about your Google Drive for Workspaces data:

- "Which team owns this service, according to the docs in our Workspace?"
- "What did the architecture review conclude about moving to event-driven ingestion?"
- "Where is the incident postmortem for last quarter’s outage?"
- "What onboarding docs exist for the payments team?"
- "Which Workspace document defines our SLA commitments?"

## Google Drive for Workspaces integration FAQ

### How is this different from the Google Drive integration?

The Google Drive integration is connected by an individual user and indexes the files, folders, and shared drives that user selects. Google Drive for Workspaces is connected once by a Google administrator against your whole organization, can cover all current and future Workspace content, and reads document permissions from your Workspace so answers stay permission-aware without each user linking an account.

### Who has to set up the connection?

A Google Super Admin in your organization. If you would rather not use a Super Admin account, create a custom admin role with read access to users, groups, and organizational units, assign it to the account you want to use, and enter that email instead.

### Can we limit what Unblocked sees?

Yes. By default Unblocked references all the contents of the connected Workspace, but you can choose specific files, folders, and drives at any time from Settings → Data Sources and save the narrower scope.

### Does it include personal Drive content?

Only when Data Shield is enabled. In that case developers can ask about their own personal Drive content in addition to shared organizational documents.

### How quickly do changes show up in answers?

Unblocked checks your Workspace’s Drive for new and updated files every 15 minutes, so edits typically appear in answers within minutes. Users, groups, and content permissions sync every hour, so access changes are reflected in Data Shield within the hour.

## Related integrations

- [Google Drive](https://getunblocked.com/integrations/google-drive/) — Google Docs, Sheets, Slides, text files, and PDFs from the files, folders, and shared drives you choose — searchable alongside code and engineering history.
- [Confluence](https://getunblocked.com/integrations/confluence/) — Pages and blog posts from the Confluence spaces you select — including rendered macro content — indexed and cited in answers.
- [Notion](https://getunblocked.com/integrations/notion/) — Pages from your Notion workspaces, indexed as cited sources so answers can draw on specs, wikis, and design docs.
- [Microsoft SharePoint](https://getunblocked.com/integrations/microsoft-sharepoint/) — Documents and pages from the SharePoint sites you select, referenced in answers with links back to the source.

## Get started with Unblocked

- Start a free trial: <https://getunblocked.com/dashboard/get-started>
- Pricing: <https://getunblocked.com/pricing/>
- Documentation: <https://docs.getunblocked.com/data-sources/google-drive-for-workspaces>
- All integrations: <https://getunblocked.com/integrations/>
