botbot-gmail

Manage Gmail threads via a JSON-configured CLI using the Gmail API.

1|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/ongspxm/mobot_skills --skill botbot-gmail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: botbot-gmail
Source: https://github.com/ongspxm/mobot_skills/tree/main/botbot-gmail
Command: npx skills add https://github.com/ongspxm/mobot_skills --skill botbot-gmail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill automates common Gmail management tasks, saving users time and effort by interacting with their inbox via a command-line interface.

Core Features & Use Cases

  • List Threads: Search and list Gmail threads based on custom queries.
  • Read Threads: Retrieve the plaintext body of the latest message in a thread.
  • Delete Threads: Trash specific threads.
  • Tag Threads: Add labels to threads.
  • Token Refresh: Automatically refreshes OAuth tokens for continued access.

Quick Start

Use the botbot-gmail skill to list all threads in your inbox.

Frequently Asked Questions about botbot-gmail

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

FAQPage Schema
How do I manage Gmail threads using a command-line interface?

You can manage Gmail threads by listing, reading, deleting, and tagging them via a JSON-configured CLI. It uses Python scripts to interact directly with the Gmail API for thread manipulation and data retrieval.

How does OAuth authentication work for Gmail API automation?

Gmail API automation uses OAuth 2.0 for authentication and automatic token refresh. This requires the `gmail.modify` scope to ensure continued secure access to your inbox.

Can I search and list specific Gmail threads via the CLI?

Yes, you can search and list Gmail threads based on custom queries through the command-line interface. The Python scripts retrieve and filter thread data directly from the Gmail API.

What is the best way to automate deleting and tagging Gmail threads?

Automating Gmail thread deletion and tagging is done via JSON-configured CLI scripts. This approach trashes specific threads and applies labels by interacting directly with the Gmail API.

How do I retrieve the plaintext body of a Gmail message programmatically?

To retrieve the plaintext body of a Gmail message programmatically, the CLI reads a thread and extracts the plaintext body of its latest message. This is handled by Python scripts querying the Gmail API.