beam-ai-team/gmail
skills/integrations/google/gmail/SKILL.md
Read, send, and manage Gmail emails. Load when user mentions 'gmail', 'email', 'send email', 'check email', 'inbox', 'draft', or references sending/reading emails.
testing
Updated Jul 8, 2026
$ install --global
skillsauthnpx skillsauth add beam-ai-team/beam-next-skills gmailInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 8, 2026, 3:53 AM344.0s2 files scanned
SKILL.md
- name:
- gmail
- type:
- skill
- version:
- 1.3
- description:
- Read, send, and manage Gmail emails. Load when user mentions 'gmail',
- author:
- Fredrik Falk
- category:
- integrations
- platform:
- Google Workspace
- updated:
- 2026-02-24
- visibility:
- public
- - approval:
- email_action
Purpose
Automate Gmail operations including reading, sending, replying, forwarding, and managing emails. Useful for email automation, inbox management, and communication workflows.
Gmail
Read, send, and manage Gmail via OAuth authentication.
CRITICAL SAFETY RULES
These rules are MANDATORY and must NEVER be bypassed:
1. NEVER Send Without Explicit Approval
- ALWAYS show the user the complete email (to, subject, body) before sending
- ALWAYS ask for explicit confirmation: "Do you want me to send this email? (yes/no)"
- NEVER auto-send emails, even if user says "send an email to X"
- NEVER send multiple emails in a loop without per-email confirmation
2. Draft-First Workflow (DEFAULT BEHAVIOR)
- ALL send/reply/forward operations create a draft FIRST
- User sees the draft and chooses:
yes(send now),no(delete draft), orkeep-draft(review in Gmail) - This ensures user can ALWAYS review in Gmail UI before any email is sent
3. Sensitive Operations Require Confirmation
| Operation | Requires Confirmation | |-----------|----------------------| | Send email | YES - ALWAYS | | Reply to email | YES - ALWAYS | | Forward email | YES - ALWAYS | | Send draft | YES - ALWAYS | | Delete draft | Yes | | Trash email | Yes |
4. Read Operations Are Safe
These do NOT require confirmation:
- List emails, Search emails, Read email content
- List labels, List drafts, Get attachment
Pre-Flight Check (ALWAYS RUN FIRST)
uv run python skills/integrations/google/google-master/scripts/google_auth.py --check --service gmail
Exit codes:
- 0: Ready to use - proceed with user request
- 1: Need to login - run
python3 skills/integrations/google/google-master/scripts/google_auth.py --login - 2: Missing credentials or dependencies - see ../google-master/references/setup-guide.md
Quick Reference
List Emails
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py list --max 10
List Unread Emails
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py list --query "is:unread" --max 10
Search Emails
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py search "from:[email protected] subject:report"
Read Email
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py read <message_id>
Send Email
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py send --to "[email protected]" --subject "Hello" --body "Message body"
Reply to Email
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py reply <message_id> --body "Reply text"
Forward Email
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py forward <message_id> --to "[email protected]"
Create Draft
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py draft --to "[email protected]" --subject "Draft" --body "Content"
List Drafts
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py drafts
List Labels
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py labels
Trash/Archive/Mark Read
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py trash <message_id>
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py archive <message_id>
uv run python skills/integrations/google/gmail/scripts/gmail_operations.py mark-read <message_id>
Gmail Search Syntax
| Operator | Example | Description |
|----------|---------|-------------|
| from: | from:[email protected] | Emails from sender |
| to: | to:[email protected] | Emails to recipient |
| subject: | subject:meeting | Subject contains word |
| is:unread | is:unread | Unread emails |
| has:attachment | has:attachment | Has attachments |
| after: | after:2024/01/01 | After date |
| before: | before:2024/12/31 | Before date |
| label: | label:important | Has label |
Error Handling
See ../google-master/references/error-handling.md for common errors and solutions.
Setup
First-time setup: ../google-master/references/setup-guide.md
Quick start:
pip install google-auth google-auth-oauthlib google-api-python-client- Create OAuth credentials in Google Cloud Console (enable Gmail API, choose "Desktop app")
- Add to
.envfile at Beam Next root:GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com GOOGLE_CLIENT_SECRET=your-client-secret GOOGLE_PROJECT_ID=your-project-id - Run
python3 skills/integrations/google/google-master/scripts/google_auth.py --login
Related Skills
beam-ai-team/use-case-proposal
tools
VerifiedTrustedCommunity
Build a Palantir-shape, PDF-native use-case proposal document for a sophisticated enterprise account: research-grounded use cases (each with description, challenge, impact, value), an operating-graph ontology page, a recommended PoC with a week-by-week plan, and a closing page that asks for one decision. Load when a client asks us to 'propose high-impact use cases', requests a use-case presentation/catalog for a function (finance, HR, ops), or when a technical evaluation team will review candidates to pick a PoC. NOT for single-account cold outreach (use prospect-brief), full process diagnostics (use operating-diagnostic), or priced proposals (use proposal-creation).
SKILL.mdUpdated Jul 8, 2026
beam-ai-team/beam-figma-to-html-slides
development
VerifiedTrustedCommunity
Convert Beam Figma slide designs into high-fidelity, editable HTML presentation decks. Use when Codex is asked to audit Figma slides, extract slide templates, rebuild Beam slides as HTML decks, decide whether Figma imagery should be exported or rebuilt in HTML/CSS, create Beam/Prism-compatible deck templates, or improve fidelity of existing Beam HTML slide rebuilds.
SKILL.mdUpdated Jul 8, 2026
beam-ai-team/beam-ai-slide-library
development
VerifiedTrustedCommunity
Use the Beam AI reusable slide library: individual HTML slide templates extracted from Beam Figma rebuilds, kept separate from deck themes and full deck templates. Load when the user asks for a slide library, specific Beam slide patterns, reusable Figma-inspired slides, Prism slide-library items, or slide-level HTML templates.
SKILL.mdUpdated Jul 8, 2026
beam-ai-team/beam-ai-deck-templates
development
VerifiedTrustedCommunity
Use Beam AI deck and report design packs, HTML templates, and curated examples to create sales decks, customer intro decks, RPO decks, and DIN A4 use-case proposal reports. Load when the user asks for Beam-branded presentation templates, Prism-compatible deck templates, Beam report templates, customer intro decks, commercial proposals, or reusable HTML deck/report examples.
SKILL.mdUpdated Jul 8, 2026