Gmail skill: read, search, send and draft Gmail emails and contacts
Multi-account Gmail access for agents via a Python CLI: search, read, send, draft, labels, stars, contacts — with mandatory user confirmation before any send
- What
- Multi-account Gmail access for agents via a Python CLI: search, read, send, draft, labels, stars, contacts — with mandatory user confirmation before any send
- Cost
- Free
- Needs
- a Google account; a one-time (~2 min) Google Cloud OAuth desktop-app client setup (Gmail API + People API enabled, scopes gmail.readonly, gmail.send, gmail.modify, contacts.readonly); Python 3.9+ with google-auth packages installed; license not asserted, so check the repo's license yourself before use
- Install
- Copy the installer prompt below into your Muse — your agent does the rest.
Curated by Skill Harbor — @idanbeck's Gmail skill: multi-account Gmail and Google contacts access for agents through a Python CLI (`gmail_skill.py`), with a mandatory user-confirmation rule before any email is sent (the agent must show full email details and get explicit approval first — no exceptions). Covers search (Gmail query syntax), read, list, send, mark read/unread, archive/unarchive, star/unstar, drafts with reply threading (`--reply-to-id` for proper In-Reply-To/References headers), labels, contact search, and account management; tokens stored locally per account. One-time setup (~2 min): create a Google Cloud OAuth desktop-app client, enable Gmail API and People API, grant scopes, download the JSON credentials. Honest caveats: the agent can send real emails from your accounts — the confirmation rule is the only safety net, keep it; apps in OAuth "testing" mode may need re-auth every 7 days unless published. Short listing: license could not be verified from the source metadata, so this fiche links only to the original repo — read it there. Skill Harbor never reviews the code, review it yourself before use. Discovered via skills.sh.
Version:
Quick answer
Gmail skill is a free listing for Idanbeck's multi-account Gmail and Google contacts access via a Python CLI. It covers search with Gmail query syntax, reading, listing, sending, read/unread marking, archiving, starring, threaded drafts, labels, contacts and accounts. Tokens are stored locally per account. A mandatory user-confirmation rule applies before any send, with full details shown and explicit approval required.
Install
Copy the install package below, then paste it into Muse🧪 Install ran in our test sandbox · Nov 11, 2026📌 Pinned version: commit 5cc3bf0Step 0 — before installing anything: read this install prompt, summarize in a few lines what this build does and what installing it involves, then ask me to confirm before you proceed. Prerequisites: a Google account; a one-time (~2 min) Google Cloud OAuth desktop-app client setup (Gmail API + People API enabled, scopes gmail.readonly, gmail.send, gmail.modify, contacts.readonly); Python 3.9+ with google-auth packages installed; license not asserted, so check the repo's license yourself before use Install "Gmail skill: read, search, send and draft Gmail emails and contacts" for me. It gives my agent multi-account Gmail access via a Python CLI: search with Gmail query syntax, read, list, send (mandatory user confirmation first — the agent must show full email details and get explicit approval), mark read/unread, archive/unarchive, star/unstar, drafts with reply threading, labels, contact search, and account management; tokens stored locally per account. Repository: https://raw.githubusercontent.com/idanbeck/claude-skills/5cc3bf0e26d79152b02971f08f9fd44afaea8dc7/gmail-skill/SKILL.md Pinned version: install the code at commit 5cc3bf0e26d79152b02971f08f9fd44afaea8dc7 exactly (Skill Harbor tested this version). Do not substitute a newer version. If this commit is unreachable, stop and tell me. 1. Fetch the SKILL.md file (and any helper files) from the repository path into a temporary folder 2. Safety check: review the SKILL.md and scripts for anything suspicious (unexpected network calls, shell commands, credential harvesting). This repo should contain zero secrets in code, credentials only via the secure vault, allowed hosts declared in the SKILL.md. Verify that holds here; STOP on any red flag and tell me. 3. Install it as a skill: copy SKILL.md and its helper files into the agent's skills directory, in a folder named "gmail-skill". 4. Verify with no network calls: frontmatter valid, files in place. 5. Report what was installed, where, and what I still need to do myself (e.g. create the Google Cloud OAuth client and download credentials.json to the skill folder, run any command once to authenticate, then ask the agent to manage your email). GitHub is optional: if I have a GitHub account or the gh CLI, you may use it; otherwise public access is fine. Never require it unless it's in the prerequisites above. Rules: don't touch anything outside the temp folder and the install target. If anything looks off, stop and ask me.
Saved to your recent installs. Find it anytime on /connect.
🔒 Security, provenance and what this touches
The install prompt below already includes the vetting steps: your agent follows the community checklist before installing anything with executable code. Want more?
Verification certificate
Dated facts about what was checked for this listing, and how. This is not a safety certification.
- Pinned version
- 5cc3bf0 · 2026-10-13
- Sandbox install test
- Install ran in our test sandbox · Nov 11, 2026
- Creator identity
- Not verified
- Fingerprint watch
- Last checked · Nov 19, 2026 : no change detected in the files linked by this install prompt
- Install prompt analysis
- 2026-10-13 : No commands, network calls, packages, file writes or API keys detected.
Skill Harbor never reviews the code of a listed skill. These are dated facts about the install prompt and our install test, not a safety certification. Review a skill yourself before you install it. How we verify
Questions
How do I install a skill?
Every product page includes a copy-paste install prompt. Paste it into your Muse and it sets the skill up for you — no manual configuration.
Where does my money go?
Straight to the seller. Skill Harbor never processes payments: checkout happens on the seller’s own page, usually Stripe.
What does the ✓ next to a creator’s name mean?
It means we confirmed the identity of the person behind the listing. It says nothing about the code itself — always check a skill before installing it.