skills.rest
vogon101
vogon101COMMUNITY
Explore all skills by this author →
Website𝕏@freddie_poserGitHub

gmail

Query and read Gmail messages via a read-only CLI.

Updated Jan 20, 2026
Search Tags:#automation#cli#search#email#inbox#gmail#read-only
One-click install
npx skills add https://github.com/vogon101/KnowledgeWork --skill gmail-vogon101
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail
Source: https://github.com/vogon101/KnowledgeWork/tree/main/skills/gmail
Command: npx skills add https://github.com/vogon101/KnowledgeWork --skill gmail-vogon101

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Read-only Gmail access via a CLI to query, search, and read messages without altering emails.

Core Features & Use Cases

  • Search emails with Gmail query syntax and filters
  • Read individual messages and full threads
  • List labels and discover contacts within the Gmail account
  • Use for inbox reviews, quick lookups, and context gathering during meetings

Quick Start

Start by configuring Gmail integration as described in the project README, then run the Gmail CLI wrapper to perform status checks, list, search, and read operations:

  • Run: .claude/skills/gmail/scripts/gmail-cli.sh status
  • List: .claude/skills/gmail/scripts/gmail-cli.sh list --limit 10
  • Search: .claude/skills/gmail/scripts/gmail-cli.sh search "from:[email protected]" --limit 5
  • Read: .claude/skills/gmail/scripts/gmail-cli.sh get MESSAGE_ID

Frequently Asked Questions about gmail

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

FAQPage Schema
How do I read Gmail messages from a CLI without modifying my inbox?▼

You can read Gmail messages via a CLI wrapper that enforces a read-only access pattern, allowing you to search and view emails without altering them. It uses a TypeScript tRPC client and server-side API integration with local credentials.

Can I search Gmail threads using standard query syntax via command line?▼

Yes, you can search Gmail threads using standard Gmail query syntax through the CLI wrapper. It supports inbox reviews, thread exploration, and contact discovery by querying the server-side Gmail API.

How do I set up local credentials for read-only Gmail API integration?▼

To set up read-only Gmail API integration, you must configure local server-side credentials as described in the project README. This enables the TypeScript tRPC client to safely query your account without modifying emails.

What is the best way to gather email context during meetings without sending replies?▼

The best way to gather email context without sending replies is using a read-only Gmail CLI. It enforces safety rules and structured outputs, letting you quickly look up messages, explore threads, and discover contacts.

Does this Gmail CLI approach allow me to list labels and discover contacts?▼

Yes, this Gmail CLI approach allows you to list labels and discover contacts within your account. It implements structured outputs via a Bash wrapper to safely query and read messages across daily workflows.

Why should I use a read-only Gmail CLI instead of a standard email client?▼

You should use a read-only Gmail CLI to inform decisions and gather context without the risk of modifying emails. It enforces safety rules and structured outputs, making it ideal for automated inbox reviews and quick lookups.

Related Skills

Explore More Content & Communication Skills→
AgentientAgentient
2

firebase-admin-sdk-server-integration

Initialize Firebase Admin SDK server-side in Next.js 14+ apps.

Official
Advanced
cellarwoodcellarwood

recipe-label-and-archive-emails

Apply Gmail labels to matching messages and archive threads.

Official
Basic
kzinmrkzinmr
7

google-workspace

Manage Gmail, Calendar, Drive, Contacts, Sheets, and Docs via Google Workspace APIs.

Community
Advanced
gigagiovagigagiova

google-workspace

Access Gmail, Calendar, Drive, Contacts, Sheets, and Docs via Python with OAuth2.

Community
Intermediate