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 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, 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 for seeded test accounts