| name | gmail-tools |
| description | Reading and managing Gmail emails - Sending emails with attachments - Replying to emails while maintaining thread continuity |
Gmail Tools
Secure Gmail access via IMAP/SMTP with 1Password credential storage. Supports listing, reading, searching, sending, and replying to emails with proper threading and attachments.
When to Use
- Reading and managing Gmail emails
- Sending emails with attachments
- Replying to emails while maintaining thread continuity
- Searching emails using IMAP queries
Prerequisites
1Password Setup
Create a 1Password item with:
- Item name: Any descriptive name (e.g., "Gmail Work Claude", "Gmail Personal")
- username field: Your Gmail address (e.g.,
user@gmail.com)
- password field: Gmail App Password (NOT your regular password)
Getting a Gmail App Password
- Go to Google Account Security
- Enable 2-Factor Authentication if not already enabled
- Go to "App passwords" (under "2-Step Verification")
- Generate a new app password for "Mail"
- Copy the 16-character password to your 1Password item
MCP Server Tools
The plugin provides these MCP tools:
list_emails
List recent emails from an account.
account: "Gmail Work Claude" # 1Password item name
folder: "INBOX" # Optional, default: INBOX
limit: 10 # Optional, default: 10
read_email
Read full email content including threading headers.
account: "Gmail Work Claude"
email_id: "46" # From list_emails
folder: "INBOX" # Optional