email

Send, read, list, search, and delete emails via the Gmail API with OAuth2.

4|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/adamhjouj/shieldclaw --skill email-adamhjouj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: email
Source: https://github.com/adamhjouj/shieldclaw/tree/main/openclaw/skills/email
Command: npx skills add https://github.com/adamhjouj/shieldclaw --skill email-adamhjouj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Gmail access from the terminal: send, read, and search emails via the Gmail API using OAuth2 authentication to streamline workflow without leaving the CLI.

Core Features & Use Cases

  • Send and read emails directly from the command line using OAuth2 credentials.
  • List and search inbox messages to monitor communications and extract metadata.
  • Use Case: Automate notification emails and lightweight inbox queries within scripts or CI workflows.

Quick Start

Run the Gmail Email Agent after configuring Gmail API credentials and set GMAIL_CREDENTIALS_FILE to your credentials file.

Frequently Asked Questions about email

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send and read Gmail messages from the terminal?

Sending and reading Gmail messages from the terminal requires a CLI tool that automates Gmail API requests using OAuth2 authentication. This approach supports sending, listing, searching, and deleting emails directly within command-line workflows.

What do I need to configure to access the Gmail API via command line?

Accessing the Gmail API via command line requires configuring Gmail API credentials and setting the GMAIL_CREDENTIALS_FILE variable to your credentials file. This enables the OAuth2 authentication flow needed for programmatic email operations.

Can I use command line email automation for CI workflows?

Command line email automation supports CI workflows by integrating Gmail API CLI commands into scripts. You can automate notification emails and perform lightweight inbox queries directly within continuous integration pipelines.

How does OAuth2 authentication work for terminal-based Gmail operations?

OAuth2 authentication for terminal-based Gmail operations uses configured credentials to authorize access and manages token caching to maintain sessions. This enables secure Gmail API interactions without requiring repeated manual logins during CLI commands.

What is the best way to search and list inbox messages from a script?

Searching and listing inbox messages from a script is best handled by CLI commands that query the Gmail API. This approach allows you to monitor communications and extract metadata programmatically within shell or automation workflows.

Does this Gmail CLI tool support deleting emails through the API?

This Gmail CLI tool supports deleting emails through the API by providing specific command line commands. You can send, list, read, search, and delete emails using your configured OAuth2 credentials and cached tokens.