Google Workspace Multi-Account Skill

Overview

When the user has connected multiple Google accounts (e.g. personal and work), you can operate across all of them simultaneously for read operations, or target a specific account for write operations.

Account Discovery

At the start of each task the system prompt lists all connected accounts:

| Label    | Email                    | Status    |
|----------|--------------------------|-----------|
| Work     | alice@company.com        | connected |
| Personal | alice@gmail.com          | connected |

Core Routing Rules

How to Specify an Account

Use either the label or the full email address:

google_gmail(command: "send ...", account: "Work")
google_gmail(command: "send ...", account: "alice@company.com")
google_calendar(command: "create ...", account: "Personal")

Common Multi-Account Workflows

Check all unread emails

google_gmail(command: "list --query 'is:unread'")

Returns results from all connected accounts, each labelled with its account.

Find free time across all calendars

google_calendar(command: "free-time --duration 60 --days 5")

Merges busy time from all connected accounts to find truly free slots.

Send from a specific account

Always confirm with the user which account to send from before calling:

google_gmail(command: "send --to 'bob@example.com' --subject 'Hi' --body 'Hello!'", account: "Work")

Reply to an email (correct account is important)

Read the email first to see which account received it, then reply from that same account:

google_gmail(command: "reply <messageId> --body 'Thanks!'", account: "Work")

Error Cases

• Account not found: If the specified label/email doesn't match any connected account, the tool returns the list of available accounts. Update the account parameter and retry.
• No accounts connected: Direct the user to Settings → Integrations → Google Accounts to connect an account.
• Token expired: If an account shows status expired, the user needs to reconnect it in Settings → Integrations → Google Accounts.