google-workspace

Gmail API access via OAuth 2.0 with support for multiple authenticated accounts. Search, read, send, reply, manage labels, and download attachments.

Tools: 13 | Auth: Google OAuth 2.0

Tools

Tool	Description
`authenticate`	Start OAuth 2.0 flow to authenticate a Gmail account
`auth_status`	Check authentication state for all configured accounts
`list_accounts`	List all authenticated Gmail accounts
`search_emails`	Search Gmail using query syntax (is:unread, from:, etc.)
`get_email`	Get single email with full content, body, headers, attachments
`get_emails_batch`	Batch read multiple emails by ID (max 50)
`get_thread`	Get full conversation thread with all messages
`send_email`	Send new email via Gmail API (plain or HTML)
`reply_to_email`	Reply to email maintaining thread (In-Reply-To, References)
`delete_email`	Trash or permanently delete email
`list_labels`	List all Gmail labels with message counts
`modify_labels`	Add/remove labels on messages
`get_attachment`	Download email attachment to disk

Supports multiple Gmail accounts simultaneously. Each account has its own OAuth token cached in .credentials/.

Standard Gmail query syntax works:

Max 100 emails per search
Attachments download to .attachments/
Requires GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET (or client_secret.json)