How do I install the Gmcli skill?

Run npx skillmds@latest add canvascoding/gmcli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gmcli safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gmcli?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gmcli free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

canvascoding (@canvascoding) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gmcli by canvascoding — Agent Skill

Name: Gmcli
Author: canvascoding

Gmcli

Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments. Triggers: Gmail, send email, search email, read email, email thread, email draft, email labels, gmcli.

canvascoding 891c1ae 2 files · 2.2 KB Updated Sep 17, 2026

File contents

Gmail CLI

Command-line interface for Gmail operations.

Installation

In Canvas Notebook Docker, a container admin installs this once:

npm install -g @mariozechner/gmcli

Check if installed:

gmcli --help

Setup

Google Cloud Console (one-time)

Create a new project (or select existing)
Enable the Gmail API
Set app name in OAuth branding
Add test users (all Gmail addresses you want to use)
Create OAuth client:
- Click "Create Client"
- Application type: "Desktop app"
- Download the JSON file

Configure gmcli

First check if already configured:

gmcli accounts list

If no accounts, guide the user through setup:

Ask if they have a Google Cloud project with Gmail API enabled
If not, walk them through the Google Cloud Console steps above
Have them download the OAuth credentials JSON
Run: gmcli accounts credentials ~/path/to/credentials.json
Run: gmcli accounts add <email> (use --manual for browserless OAuth)

Usage

Run gmcli --help for full command reference.

Common operations:

gmcli <email> search "<query>" - Search emails using Gmail query syntax
gmcli <email> thread <threadId> - Read a thread with all messages
gmcli <email> send --to <emails> --subject <s> --body <b> - Send email
gmcli <email> labels list - List all labels
gmcli <email> drafts list - List drafts

Data Storage

~/.gmcli/credentials.json - OAuth client credentials
~/.gmcli/accounts.json - Account tokens
~/.gmcli/attachments/ - Downloaded attachments

---name: gmclidescription: Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments. Triggers: Gmail, send email, search email, read email, email thread, email draft, email labels, gmcli.---# Gmail CLICommand-line interface for Gmail operations.## InstallationIn Canvas Notebook Docker, a container admin installs this once:```bashnpm install -g @mariozechner/gmcli```Check if installed:```bashgmcli --help```## Setup### Google Cloud Console (one-time)1. [Create a new project](https://console.cloud.google.com/projectcreate) (or select existing)2. [Enable the Gmail API](https://console.cloud.google.com/apis/api/gmail.googleapis.com)3. [Set app name](https://console.cloud.google.com/auth/branding) in OAuth branding4. [Add test users](https://console.cloud.google.com/auth/audience) (all Gmail addresses you want to use)5. [Create OAuth client](https://console.cloud.google.com/auth/clients): - Click "Create Client" - Application type: "Desktop app" - Download the JSON file### Configure gmcliFirst check if already configured:```bashgmcli accounts list```If no accounts, guide the user through setup:1. Ask if they have a Google Cloud project with Gmail API enabled2. If not, walk them through the Google Cloud Console steps above3. Have them download the OAuth credentials JSON4. Run: `gmcli accounts credentials ~/path/to/credentials.json`5. Run: `gmcli accounts add <email>` (use `--manual` for browserless OAuth)## UsageRun `gmcli --help` for full command reference.Common operations:- `gmcli <email> search "<query>"` - Search emails using Gmail query syntax- `gmcli <email> thread <threadId>` - Read a thread with all messages- `gmcli <email> send --to <emails> --subject <s> --body <b>` - Send email- `gmcli <email> labels list` - List all labels- `gmcli <email> drafts list` - List drafts## Data Storage- `~/.gmcli/credentials.json` - OAuth client credentials- `~/.gmcli/accounts.json` - Account tokens- `~/.gmcli/attachments/` - Downloaded attachments

Frequently asked questions