gmcli

Automate Gmail search, read, send, draft, and label operations via a Bash CLI.

10|2|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/canvascoding/canvas-notebook --skill gmcli-canvascoding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gmcli
Source: https://github.com/canvascoding/canvas-notebook/tree/main/seed_skills/gmcli
Command: npx skills add https://github.com/canvascoding/canvas-notebook --skill gmcli-canvascoding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail workflow management from the command line speeds up searching, reading conversations, composing and sending messages, and organizing drafts and labels without switching to a browser.

Core Features & Use Cases

  • Search emails using Gmail query syntax and filter results quickly.
  • Read entire threads to review conversation history.
  • Send new messages and manage drafts, labels, and attachments from scripts or interactive prompts.
  • Work across multiple accounts with local credential storage and simple setup.

Quick Start

Search emails from the connected Gmail account for recent messages containing 'invoice'.

Frequently Asked Questions about gmcli

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

FAQPage Schema
How do I search and read Gmail threads from the command line?

You can search and read Gmail threads from the command line by using a Bash-based CLI tool that applies Gmail query syntax to filter results and display entire conversation histories. This allows you to quickly locate and review messages without opening a browser.

Can I send emails and manage Gmail drafts using a CLI?

Yes, you can send emails and manage Gmail drafts using a CLI through command-based interactions and scripts. The tool supports composing new messages and organizing drafts directly from your terminal environment.

Do I need OAuth credentials to manage Gmail accounts via a CLI tool?

Yes, you need OAuth credentials to manage Gmail accounts via a CLI tool. The integration relies on local credential storage to authenticate and support operations across multiple accounts securely.

What is the best way to automate Gmail workflows without switching to a browser?

The best way to automate Gmail workflows without a browser is using a command line interface to execute operations like searching, reading, sending, and organizing labels. This accelerates everyday email management directly within scripts or interactive prompts.

Does Gmail CLI support organizing labels and attachments across multiple accounts?

Yes, Gmail CLI supports organizing labels and attachments across multiple accounts. It uses local credential storage to manage different profiles and enables label management and attachment handling through command-based interactions.