← Back to Skills Marketplace
38
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install gmail-local
Description
Local Gmail IMAP/SMTP access using a Google App Password. Use when the user wants to search, read, or send Gmail without routing mail through Maton or any th...
README (SKILL.md)
Gmail Local
Use direct Gmail IMAP/SMTP with a Google App Password. This skill does not use Maton or any third-party proxy.
Trust Boundary
- Mail goes directly between this host and Google Gmail servers:
- IMAP:
imap.gmail.com:993 - SMTP:
smtp.gmail.com:465These endpoints are fixed in the helper and are not configurable by environment variable.
- IMAP:
- Credentials stay local and must be provided through:
GMAIL_ADDRESSGMAIL_APP_PASSWORD_FILE
- Never print, log, commit, or echo the app password. Do not pass it directly as an environment variable.
- App Passwords require Google 2-Step Verification and may be unavailable for some accounts, Workspace policies, or Advanced Protection accounts.
- IMAP must be enabled in Gmail settings.
Commands
The local helper is under this skill folder:
scripts/gmail_local.py
List recent Inbox messages:
python3 scripts/gmail_local.py list --limit 10
Search with an IMAP query:
python3 scripts/gmail_local.py search --query 'UNSEEN'
python3 scripts/gmail_local.py search --query 'FROM "[email protected]"'
Read a message by UID:
python3 scripts/gmail_local.py read --uid 12345
Send mail only after explicit approval:
python3 scripts/gmail_local.py send \
--to [email protected] \
--subject "Subject" \
--body "Message body" \
--confirm-send
Safety Rules
- Before
send, showto,cc,bcc,subject, and a body preview, then get explicit user approval. - The helper refuses to send unless
--confirm-sendis provided after that approval. - Do not use this skill to mass-mail, spam, scrape contacts, or send sensitive data without confirmation.
- Prefer read-only commands (
list,search,read) unless the user clearly asks to send. - If an authentication error occurs, do not retry repeatedly; ask the user to check IMAP settings and rotate the App Password if needed.
Setup
Create a Google App Password at:
https://myaccount.google.com/apppasswords
Store it in a local 0600 file:
install -m 600 /dev/null ~/.openclaw/gmail-app-password
nano ~/.openclaw/gmail-app-password
Then set local environment for the gateway service. Example:
openclaw config set env.vars.GMAIL_ADDRESS [email protected]
openclaw config set env.vars.GMAIL_APP_PASSWORD_FILE ~/.openclaw/gmail-app-password
openclaw gateway restart
Usage Guidance
Install only if you are comfortable giving this local helper IMAP/SMTP access to your Gmail account. Store the app password in a 0600 file, revoke it when unused, review email content carefully, and require explicit approval before any send.
Capability Analysis
Type: OpenClaw Skill
Name: gmail-local
Version: 1.0.0
The gmail-local skill provides standard IMAP/SMTP functionality for Gmail using local credentials. The Python script (scripts/gmail_local.py) implements good security practices by enforcing strict file permissions (0600) on the credential file and hardcoding official Google endpoints. It includes a mandatory confirmation flag for sending emails to prevent accidental or unauthorized automated mailing.
Capability Assessment
Purpose & Capability
The artifacts match the stated purpose of local Gmail IMAP/SMTP access, including searching, reading, and sending mail; those capabilities are sensitive but disclosed and purpose-aligned.
Instruction Scope
Send operations are documented as requiring explicit approval and the helper enforces a --confirm-send flag, but the user and agent must still ensure the flag is only used after real user approval.
Install Mechanism
There is no install script or external package installation; the included Python helper uses standard library modules and fixed Gmail endpoints.
Credentials
The required Gmail address and app-password file are proportionate for IMAP/SMTP access, and the code checks ownership and restrictive permissions before reading the password.
Persistence & Privilege
No background process or self-persistence is shown, but the local app-password file is a persistent credential that should be protected and revoked when no longer needed.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gmail-local - After installation, invoke the skill by name or use
/gmail-local - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: local Gmail IMAP/SMTP skill without Maton or third-party proxy.
Metadata
Frequently Asked Questions
What is Gmail Local?
Local Gmail IMAP/SMTP access using a Google App Password. Use when the user wants to search, read, or send Gmail without routing mail through Maton or any th... It is an AI Agent Skill for Claude Code / OpenClaw, with 38 downloads so far.
How do I install Gmail Local?
Run "/install gmail-local" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gmail Local free?
Yes, Gmail Local is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gmail Local support?
Gmail Local is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gmail Local?
It is built and maintained by Alan Wen (@alanwen168); the current version is v1.0.0.
More Skills