google-workspace
Covers Gmail, Google Calendar, Google Drive, Google Sheets, and Google Contacts. Error responses match the Google APIs format.
MCP tools
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. When used with--proxy or route mode, HTTP calls to these domains get redirected to the twin:
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 validation
--proxy), it can send emails, create drafts, manage labels, create calendar events, read Drive files, and update spreadsheets through the REST endpoints.
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 |