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.
Twin ID: google-workspace
Covers Gmail, Google Calendar, Google Drive, Google Sheets, and Google Contacts. Error responses match the Google APIs format.
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 twin also handles REST API calls to the Google API domains. High-fidelity runs use a controlled runtime that maps real Google service domains through Archal TLS interception, so HTTP calls to these domains are redirected to the twin without harness code changes.
gmail.googleapis.com — read, send, draft, label, trash, modifycalendar.googleapis.com — list, create, update, delete eventsdrive.googleapis.com — list, read, search filessheets.googleapis.com — read and update spreadsheetspeople.googleapis.com — contactsoauth2.googleapis.com/token — OAuth refresh. The twin accepts any client_id / refresh_token pair and returns a synthetic access token bound to the seed’s primary account, so harnesses holding real-Google OAuth credentials boot without needing a twin-issued token.
The REST surface covers more operations than the MCP tools above. If your agent uses the Google client libraries directly, the proxy routes them to the twin so it can send emails, create drafts, manage labels, create calendar events, read Drive files, and update spreadsheets through the REST endpoints.
Interception depends on a controlled runtime that maps Google service domains to Archal and trusts the Archal CA. See Route-mode trust and safety for runtime compatibility and troubleshooting.
Seeds
| Seed | Description |
|---|
empty | Clean account |
assistant-baseline | Inbox with a few emails and calendar events |
gmail-busy-inbox | Many emails across categories |
calendar-packed-week | Busy calendar for scheduling tests |
calendar-conflict-resolution | Overlapping events for conflict-handling tests |
draft-send-cleanup | Drafts and sent items |
email-to-ticket-pipeline | Emails that map to external tickets |
multi-account-baseline | Multiple account setup |
