# Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token

**Category:** 💬 Communication  
**Repository:** https://github.com/adelaidasofia/google-workspace-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/multi-account-mcp-for-gmail-calendar-drive-docs-and-sheets-61-tools-token

## Description
Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token-efficient, macOS…

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "multi-account-mcp-for-gmail-calendar-drive-docs-and-sheets-61-tools-token": {
    "command": "npx",
    "args": ["-y","multi-account-mcp-for-gmail-calendar-drive-docs-and-sheets-61-tools-token"]
  }
}
```

## Documentation & README

# google-workspace-mcp


<!-- mycelium-badges:start -->

<p>
  <a href="https://github.com/adelaidasofia/google-workspace-mcp/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/adelaidasofia/google-workspace-mcp?color=blue"></a>
  <a href="https://github.com/adelaidasofia/google-workspace-mcp/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/adelaidasofia/google-workspace-mcp?color=eab308"></a>
  <a href="https://github.com/adelaidasofia/google-workspace-mcp/commits/main"><img alt="Last commit" src="https://img.shields.io/github/last-commit/adelaidasofia/google-workspace-mcp"></a>
  <a href="https://github.com/adelaidasofia/google-workspace-mcp/issues"><img alt="Open issues" src="https://img.shields.io/github/issues/adelaidasofia/google-workspace-mcp"></a>
  <a href="https://pypi.org/project/adelaidasofia-google-workspace-mcp/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/adelaidasofia-google-workspace-mcp?color=blue&label=pypi"></a>
  <a href="https://pypi.org/project/adelaidasofia-google-workspace-mcp/"><img alt="PyPI downloads" src="https://img.shields.io/pypi/dm/adelaidasofia-google-workspace-mcp?color=blue&label=downloads"></a>
  <a href="https://myceliumai.co"><img alt="Built by Mycelium AI" src="https://img.shields.io/badge/built_by-Mycelium_AI-15B89A"></a>
</p>

<!-- mycelium-badges:end -->

Multi-account, token-efficient MCP for **Gmail + Calendar + Drive + Docs + Sheets**.
Built because the official Claude connector supports one account and returns full
message/file bodies by default.

## Why this exists

- **Multi-account**: OAuth multiple mailboxes (work + personal + co-founder). Every
  tool takes an `account` email; aliases are handled via Send-As identities.
- **Token-efficient**: Search/list returns compact shapes (`{id, from, subject,
  snippet, ...}` for mail, `{id, name, mime, modified, size, ...}` for Drive).
  Bodies and file content are opt-in.
- **Keychain-backed**: Refresh tokens live in the macOS Keychain, not plaintext
  files. No tokens in the vault, no tokens in any repo.

## Tools (v2, 61 tools)

### Account management (3)
- `gws_account_add` — browser OAuth flow, adds a new authorized mailbox
- `gws_account_list` — list authorized accounts + default
- `gws_account_remove` — remove local credential (doesn't revoke Google-side)

### Gmail (10)
- `gmail_search` — search with Gmail operators. Compact response.
- `gmail_read` — read one message or full thread. Bodies opt-in.
- `gmail_send` — send mail, optional `from_alias` for Send-As identities
- `gmail_draft` — create a draft
- `gmail_reply` — reply (preserves thread + headers), optional reply_all
- `gmail_labels_list` — list all labels
- `gmail_label_apply` — batch add/remove labels
- `gmail_archive` — batch archive (remove INBOX)
- `gmail_trash` — batch move to trash
- `gmail_sendas_list` — list Send-As identities on this mailbox

### Calendar (7)
- `cal_list_calendars` — list all calendars
- `cal_list_events` — list upcoming events (compact by default, `verbose=True` for full)
- `cal_create_event` — create event, optional Google Meet link
- `cal_update_event` — partial-update fields
- `cal_delete_event` — delete
- `cal_freebusy` — check busy windows for scheduling
- `cal_respond` — accept/decline/tentative

### Drive (18)
- `drive_search` — free-text or raw Drive q-syntax. Metadata-only response.
- `drive_read_file` — metadata by default; `include_content=True` for body
- `drive_list_folder` — direct children of a folder (`'root'` for My Drive)
- `drive_create_folder` — create a folder under an optional parent
- `drive_upload` — upload a local file, optional `convert_to_google`
- `drive_move` — change parent folder
- `drive_rename` — rename a file or folder
- `drive_share` — grant reader/commenter/writer/etc. access by email
- `drive_trash` — soft delete (recoverable)
- `drive_untrash` — restore from Trash
- `drive_permission_list` — list everyone with access to a file
- `drive_permission_update` — change a grantee's role
- `drive_permission_delete` — revoke a permission
- `drive_shared_drives_list` — list shared drives this account accesses
- `drive_comments_list` — list comments on any Drive file (Doc/Sheet/Slide/upload)
- `drive_comment_add` — add a comment, optional anchor
- `drive_comment_reply` — reply to a comment
- `drive_comment_resolve` — mark a comment resolved

### Docs (9)
- `docs_create` — new Doc, optional initial body and parent folder
- `docs_read` — flat text by default; `structured=True` for full Docs API tree
- `docs_append` — append text to end of body
- `docs_insert_at` — insert text at a specific index
- `docs_replace_text` — find-and-replace, returns count replaced
- `docs_export` — export to markdown / pdf / docx / rtf / plain
- `docs_suggestions_list` — list pending tracked-change suggestions
- `docs_suggestions_accept_all` — accept all suggestions (rewrites Doc)
- `docs_suggestions_reject_all` — reject all suggestions (rewrites Doc)

### Sheets (14)
- `sheets_create` — new workbook, optional parent folder
- `sheets_list_sheets` — list tabs with row/col dimensions
- `sheets_add_sheet` — add a new tab to an existing workbook
- `sheets_read_range` — read A1 range. `FORMULA` / `UNFORMATTED_VALUE` options.
- `sheets_write_range` — overwrite a range. `USER_ENTERED` parses formulas.
- `sheets_append` — append rows below existing data
- `sheets_clear_range` — clear values (formatting preserved)
- `sheets_batch_read` — multi-range read in one API call
- `sheets_batch_write` — multi-range write in one API call
- `sheets_named_ranges_list` — list named ranges in a workbook
- `sheets_named_range_add` — create a named range
- `sheets_named_range_delete` — delete a named range
- `sheets_conditional_format_add` — add a conditional formatting rule
- `sheets_data_validation_add` — set dropdown / number / email / URL validation

## Install

Open Claude Code, paste:

    /plugin marketplace add adelaidasofia/google-workspace-mcp
    /plugin install google-workspace-mcp@google-workspace-mcp

You still need to complete the one-time GCP setup in [SETUP.md](SETUP.md)
(~45 min for v1, ~5 min incremental for v2 Drive/Docs/Sheets) so the
server has a `client_secret.json` to OAuth against. Run `gws_account_add`
from Claude Code to authorize your first mailbox.

<details>
<summary>Legacy install (manual <code>.mcp.json</code> wiring)</summary>

See [SETUP.md](SETUP.md) for the one-time GCP setup (~45 min for v1, ~5 min
incremental to enable Drive/Docs/Sheets for v2).

After setup:
```bash
pip3 install --break-system-packages -r requirements.txt
```

### Register with Claude Code

Add to your project's `.mcp.json` (or `~/.claude.json` for global access):
```json
"google-workspace": {
  "type": "stdio",
  "command": "python3",
  "args": ["/path/to/google-workspace-mcp/server.py"]
}
```

</details>

## Upgrading from v1 → v2

v2 adds Drive + Docs + Sheets scopes. **Each authorized account must re-OAuth
once** so Google grants the new scopes. See SETUP.md step 6b.

## Roadmap

- **v3**: Gmail filters, vacation responder, push notifications (Gmail Watch),
  Calendar ACL/delegation, Slides, Forms, Tasks
- **v4**: Batch requests across services, Drive revisions

## Related MCPs

Same author, same architecture pattern (FastMCP, draft+confirm on writes where applicable, vault auto-export, MIT):

- [slack-mcp](https://github.com/adelaidasofia/slack-mcp) — multi-workspace Slack
- [imessage-mcp](https://github.com/adelaidasofia/imessage-mcp) — macOS iMessage
- [whatsapp-mcp](https://github.com/adelaidasofia/whatsapp-mcp) — WhatsApp via whatsmeow
- [apollo-mcp](https://github.com/adelaidasofia/apollo-mcp) — Apollo.io CRM + sequences
- [substack-mcp](https://github.com/adelaidasofia/substack-mcp) — Substack writing + analytics
- [luma-mcp](https://github.com/adelaidasofia/luma-mcp) — lu.ma events
- [parse-mcp](https://github.com/adelaidasofia/parse-mcp) — markitdown / Docling / LlamaParse router
- [rescuetime-mcp](https://github.com/adelaidasofia/rescuetime-mcp) — RescueTime productivity data
- [graph-query-mcp](https://github.com/adelaidasofia/graph-query-mcp) — vault knowledge graph queries
- [graph-autotagger-mcp](https://github.com/adelaidasofia/graph-autotagger-mcp) — wikilink suggestions from the graph
- [investor-relations-mcp](https://github.com/adelaidasofia/investor-relations-mcp) — seed-raise pipeline tracker
- [vault-sync-mcp](https://github.com/adelaidasofia/vault-sync-mcp) — bidirectional vault sync


## Telemetry

This plugin sends a single anonymous install signal to `myceliumai.co` the first time it loads in a Claude Code session on a given machine.

**What is sent:**
- Plugin name (e.g. `slack-mcp`)
- Plugin version (e.g. `0.1.0`)

**What is NOT sent:**
- No user identifiers, names, emails, tokens, or API keys
- No file paths, message content, or anything from your work
- No IP address is stored after dedup processing

**Why:** Helps the maintainer know which plugins people actually install, so attention goes to the ones that get used.

**Opt out:** Set the environment variable `MYCELIUM_NO_PING=1` before launching Claude Code. The hook will skip the network call entirely. Already-pinged installs leave a sentinel at `~/.mycelium/onboarded-<plugin>` — delete it if you want to reset state.

## License

MIT

---

Built by [Mycelium AI](https://myceliumai.co). Full install or team version at [diazroa.com](https://diazroa.com).