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

# Google Workspace clone

> Test agents against a stateful clone of Gmail, Google Calendar, Drive, Sheets, and Contacts with real Google API error shapes and MCP tools.

Clone ID: `google-workspace`

Covers Gmail, Google Calendar, Google Drive, Google Sheets, and Google Contacts. Error responses match the Google APIs format.

## Start here

| Question     | Answer                                                                                                                                              |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Best for     | Agents that read email, schedule meetings, inspect Drive files, update sheets, or reason across inbox and calendar state.                           |
| Connect with | Route mode for supported Google API domains, direct REST base URLs from `archal clone start google-workspace`, or MCP for Gmail and Calendar flows. |
| Known limits | MCP tools currently cover Gmail and Calendar. REST/API routing covers the broader Google Workspace surfaces listed below.                           |
| Seeds        | Common seeds: `assistant-baseline`, `gmail-busy-inbox`, `calendar-packed-week`, `empty`. See [Seeds](/guides/seeds) for usage.                      |

## MCP tools

The MCP surface is intentionally narrower than REST/API routing. Use MCP for
common Gmail and Calendar tasks; use route mode or explicit REST base URLs for
Drive, Sheets, Contacts, and OAuth-style flows.

### Gmail

| Tool                    | Description                                            |
| ----------------------- | ------------------------------------------------------ |
| `gmail_search_messages` | Search messages by query (same syntax as Gmail search) |
| `gmail_get_message`     | Get a single message by ID                             |
| `gmail_get_thread`      | Get a conversation thread                              |
| `gmail_list_threads`    | List threads in a mailbox                              |
| `gmail_get_profile`     | Get the authenticated user's email profile             |

### Calendar

| Tool                      | Description                             |
| ------------------------- | --------------------------------------- |
| `calendar_list_calendars` | List all calendars                      |
| `calendar_list_events`    | List events in a calendar               |
| `calendar_get_event`      | Get a single event                      |
| `calendar_get_free_busy`  | Check free/busy status for a time range |

## REST API coverage

The clone also handles REST calls to Google API domains.

* `gmail.googleapis.com` - read, send, draft, label, trash, modify
* `calendar.googleapis.com` - list, create, update, delete events
* `drive.googleapis.com` - list, read, search files
* `sheets.googleapis.com` - read and update spreadsheets
* `people.googleapis.com` - contacts
* `oauth2.googleapis.com/token` - OAuth refresh for seeded test accounts

If your agent uses Google client libraries directly, the proxy routes supported
calls to the clone.

See [Route-mode trust and safety](/guides/route-mode-safety) for runtime
compatibility and troubleshooting.