gmail SKILL.md skillA

gmail from sanjay3290/ai-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sanjay3290/ai-skills/gmail@v1.0

Pins v1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sanjay3290/ai-skills
Path
skills/gmail/SKILL.md
Versions recorded
5
Latest version
v1.0, committed Feb 19, 2026
First version recorded
Jan 20, 2026
Size
4,949 bytes
Repository stars
450
License
Apache-2.0

Interact with Gmail - search emails, read messages, send emails, create drafts, and manage labels. Use when user asks to: search email, read email, send email, create email draft, mark as read, archive email, star email, or manage Gmail labels. Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Gmail

Lightweight Gmail integration with standalone OAuth authentication. No MCP server required.

> **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported.

## First-Time Setup

Authenticate with Google (opens browser):
```bash
python scripts/auth.py login
```

Check authentication status:
```bash
python scripts/auth.py status
```

Logout when needed:
```bash
python scripts/auth.py logout
```

## Commands

All operations via `scripts/gmail.py`. Auto-authenticates on first use if not logged in.

### Search Emails

```bash
# Search with Gmail query syntax
python scripts/gmail.py search "from:someone@example.com is:unread"

# Search recent emails (no query returns all)
python scripts/gmail.py search --limit 20

# Filter by label
python scripts/gmail.py search --label INBOX --limit 10

# Include spam and trash
python scripts/gmail.py search "subject:important" --include-spam-trash
```

### Read Email Content

```bash
# Get full message content
python scripts/gmail.py get MESSAGE_ID

# Get just metadata (headers)
python scripts/gmail.py get MESSAGE_ID --format metadata

# Get minimal response (IDs only)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sanjay3290/ai-skills/gmail@sha256:d0cd4ce59fa0a5e5

The line at the top of this page pins the label v1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_t7yh5cabynt3ufh3.svg)](https://markdownregistry.com/a/art_t7yh5cabynt3ufh3)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jan 20, 2026 and Feb 19, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
v1.0 latest2026-02-19 eab1642 4,949 BA view · diff
git:20260212.e84fbf62026-02-12 e84fbf6 4,881 BA view · diff
git:20260210.4e13c632026-02-10 4e13c63 5,406 BA view · diff
git:20260210.6bd28e62026-02-10 6bd28e6 4,875 BA view · diff
git:20260120.a227ddc2026-01-20 a227ddc 4,684 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4949 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

sanjay3290/ai-skills · 450 stars · license Apache-2.0 · pushed 2026-09-10 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_t7yh5cabynt3ufh3
GET https://markdownregistry.com/api/v1/resolve?ref=sanjay3290/ai-skills/gmail
GET https://markdownregistry.com/api/v1/blob/d0cd4ce59fa0a5e50827c5f0222a091a21ab6d8d143f772ea7e22ddb58982ba7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from sanjay3290/ai-skills

apple-container SKILL.md skill
sanjay3290/ai-skills · skills/apple-container/SKILL.md · Apple's open-source `container` CLI to build, run, and manage OCI/Linux containers as lightweight per-container VMs on…
v1.0 · audit A · 450 stars
atlassian SKILL.md skill
sanjay3290/ai-skills · skills/atlassian/SKILL.md · Manage Jira issues and Confluence wiki pages in Atlassian Cloud. Use when: (1) searching/creating/updating Jira issues…
git:20260303.e4c0b94 · audit A · 450 stars
azure-devops SKILL.md skill
sanjay3290/ai-skills · skills/azure-devops/SKILL.md · Manage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts, variable groups…
v1.0 · audit A · 450 stars
deep-research SKILL.md skill
sanjay3290/ai-skills · skills/deep-research/SKILL.md · Execute autonomous multi-step research using Google Gemini Deep Research Agent. Use for: market analysis, competitive…
v1.0 · audit A · 450 stars
elevenlabs SKILL.md skill
sanjay3290/ai-skills · skills/elevenlabs/SKILL.md · Convert documents and text to audio using ElevenLabs text-to-speech. Use this skill when the user wants to create a…
v1.0 · audit A · 450 stars
google-calendar SKILL.md skill
sanjay3290/ai-skills · skills/google-calendar/SKILL.md · Interact with Google Calendar - list calendars, view events, create/update/delete events, and find free time. Use when…
v1.0 · audit A · 450 stars
google-chat SKILL.md skill
sanjay3290/ai-skills · skills/google-chat/SKILL.md · Interact with Google Chat - send, read, edit, delete and react to messages, share images and files, reply in threads…
v1.1 · audit A · 450 stars
google-docs SKILL.md skill
sanjay3290/ai-skills · skills/google-docs/SKILL.md · Interact with Google Docs - create documents, search by title, read content, and edit text. Use when user asks to…
v1.0 · audit A · 450 stars
google-drive SKILL.md skill
sanjay3290/ai-skills · skills/google-drive/SKILL.md · Interact with Google Drive - search files, find folders, list contents, download files, upload files, create folders…
v1.0 · audit A · 450 stars
google-sheets SKILL.md skill
sanjay3290/ai-skills · skills/google-sheets/SKILL.md · Read and write Google Sheets spreadsheets - get content, update cells, append rows, fetch specific ranges, search for…
v1.0 · audit A · 450 stars
google-slides SKILL.md skill
sanjay3290/ai-skills · skills/google-slides/SKILL.md · Read and write Google Slides presentations - get text, find presentations, create presentations, add slides, replace…
v1.0 · audit A · 450 stars
google-tts SKILL.md skill
sanjay3290/ai-skills · skills/google-tts/SKILL.md · Convert documents and text to audio using Google Cloud Text-to-Speech. Use this skill when the user wants to: narrate a…
git:20260224.aaebbc7 · audit A · 450 stars

Every file in sanjay3290/ai-skills

Other files named gmail

gmail SKILL.md skill
vellum-ai/vellum-assistant · skills/gmail/SKILL.md · Manage Gmail email — drafting, sending, organizing, filters, vacation replies, and inbox analysis
git:20260912.3df3699 · audit A · 1,467 stars
gmail SKILL.md skill
hyperfx-ai/marketing-skills · skills/gmail/SKILL.md · Manage Gmail end-to-end — send, reply, search, drafts, labels, attachments, and inbox organization. Use when the user…
git:20261026.db79518 · audit A · 107 stars
gmail SKILL.md skill
vargasjr-dev/mycadet-temp · skills/gmail/SKILL.md · Manage Gmail email — drafting, sending, organizing, filters, vacation replies, and inbox analysis
git:20261007.09b94d2 · audit A · 47 stars
gmail SKILL.md skill
ampcode/official-plugins · skills/gmail/SKILL.md · Reads, searches, sends, archives, and labels Gmail messages. Use when working with Gmail or email.
git:20261025.c3c2206 · audit A · 21 stars
gmail SKILL.md skill
xaiht/tlamatini · Tlamatini/agent/skills_pkg/gmail/SKILL.md · Read and send Gmail messages and threads via Gmail API.
git:20261027.1d13922 · audit A · 15 stars
gmail SKILL.md skill
tonydzi/second-brain-starter-kit · skills/gmail/SKILL.md · Check, search or digest Gmail across several mailboxes over the owner's own OAuth connector, with no browser and…
git:20261007.cd6c208 · audit A · 13 stars
gmail SKILL.md skill
pr-e/openclaw-master-skills · skills/gmail/SKILL.md · Gmail API integration with managed OAuth. Read, send, and manage emails, threads, labels, and drafts. Use this skill…
v1.0 · audit A · 3 stars

Browse by kind, by grade A, or by owner.