Agent skill · software engineering · aiskillstore
gmail-tools
Access Gmail through IMAP and SMTP using credentials retrieved from a named 1Password item. The included scripts list emails, read messages, and send threaded replies with optional attachments.
Why this skill is useful
Adds executable scripts for managing Gmail via IMAP/SMTP that are not commonly found in public documentation.
What it needs
Requires python installed locally. Requires 1password, gmail account access. About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
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 1. Go to Google Account Security 2. Enable 2-Factor Authentication if not already enabled 3. Go to "App passwords" (under "2-Step Verification") 4. Generate a new app password for "Mail" 5. Copy the 16-character password to your 1Password item MCP Server Tools The plugin provides these MCP tools: listemails List recent emails from an account. reademail Read full email content including threading headers. sendemail Send a new email with optional attachments. replyemail Reply to an email, maintaining the thread. searchemails Search using IMAP syntax. Standalone Scripts For CLI usage without MCP, use scripts in scripts/: List Emails Read Email Reply to Email Email Threading When using replyemail, the tool automatically: 1. Extracts the original email's Message-ID and References headers 2. Sets In-Reply-To to the original Message-ID 3. Builds proper References header chain 4. Adds RE: prefix to subject if not present 5. Sends to the sender's email address This ensures replies appear in the same thread in all email clients. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/gmail-tools