---
name: gws-multi-account
description: Guidance for working across multiple connected Google accounts — managing email, calendar events, and files for personal and work accounts simultaneously.
command: /gws-multi-account
verified: true
---

# 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

| Operation type                                           | When `account` is omitted             | When `account` is specified        |
| -------------------------------------------------------- | ------------------------------------- | ---------------------------------- |
| **Read** (list, search, get, free-time)                  | Queries **all** accounts              | Queries only the specified account |
| **Write** (send, reply, create, update, delete, archive) | **Ask the user** which account to use | Uses the specified account         |

## 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.