Skip to main content
skill CX Codex

c-email — Claude Code skill: what it does, how to install

Manages email through gog for Gmail and himalaya for IMAP accounts. Helps your agent search messages, read threads, and send replies.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add daxaur/openpaw --skill c-email -a claude-code
Open on GitHub

What c-email does

This skill teaches the coding agent how to handle mailboxes using external command-line utilities. For Google accounts, it relies on gog. That enables search queries with Gmail syntax, label assignments, and thread inspection via gog mail thread. For standard IMAP providers, it switches to himalaya to list folders, forward messages, and archive mail.

The skill contains no built-in client. You must have gog or himalaya installed locally, which you can verify with which gog himalaya. Prior authentication is mandatory: gog needs OAuth authorization configured via gog auth, while himalaya reads your account details from ~/.config/himalaya/config.toml.

What it helps with

  • search Gmail messages using filters like is:unread or has:attachment
  • read full conversation threads directly inside the agent session
  • send new emails and replies through gog or himalaya
  • sort messages into IMAP folders or manage Gmail labels

Example prompts for the agent

  • Search Gmail for unread messages with subject report
  • Read the message thread with ID 18e3a2b4 using gog
  • Send a reply to message 42 via himalaya using body.txt

How to install c-email

1Skills CLI (Vercel)

npx skills add daxaur/openpaw --skill c-email -a claude-code

2Manually: put the files in place

~/.claude/skills/c-email/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/c-email/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about c-email

How to install c-email in Claude Code?

Run npx skills add daxaur/openpaw --skill c-email -a claude-code in your terminal. You can also save the file directly to ~/.claude/skills/c-email/SKILL.md.

What does c-email do?

It guides the assistant to manage your inbox via the gog and himalaya CLI tools. The agent can inspect message threads, run mailbox searches, draft replies, and organize folders.

What dependencies are required for c-email?

You need either gog or himalaya installed on your system. Gmail access requires running gog auth for OAuth, while IMAP accounts need credentials in ~/.config/himalaya/config.toml.

Source text

SKILL.md · MIT
---
name: c-email
description: Read, send, search, and label email via gog (Gmail CLI) or himalaya (IMAP). Supports inbox management, drafting replies, thread viewing, and label/folder operations across Gmail and standard IMAP accounts.
tags: [email, gmail, imap, gog, himalaya, inbox]
---

This skill manages email via `gog` (Gmail) or `himalaya` (IMAP). Check availability with `which gog himalaya`.

## Gmail — `gog mail` (gogcli)

```bash
gog mail list                              # List inbox messages
gog mail list --label "INBOX" --max 20
gog mail read <message-id>                 # Read a message
gog mail send --to "[email protected]" --subject "Subject" --body "Body"
gog mail reply <message-id> --body "Reply text"
gog mail search "from:alice subject:report"
gog mail search "is:unread after:2026/02/01"
gog mail label add <message-id> "Label"
gog mail label remove <message-id> "INBOX"
gog mail archive <message-id>
gog mail trash <message-id>
gog mail labels                            # List all labels
gog mail thread <thread-id>                # View full thread
```

## IMAP — `himalaya`

```bash
himalaya list                              # List inbox
himalaya list -m 50                        # List last 50 messages
himalaya read <id>                         # Read message
himalaya write                             # Compose new message (interactive)
himalaya send --to "[email protected]" --subject "Subj" < body.txt
himalaya reply <id>
himalaya forward <id>
himalaya search "subject:report"
himalaya move <id> "Archive"               # Move to folder
himalaya delete <id>
himalaya folders                           # List folders
himalaya --account work list               # Use a specific account
```

## Usage Guidelines

- Prefer `gog` for Gmail accounts; prefer `himalaya` for non-Gmail IMAP.
- Use `gog mail search` with Gmail search syntax (from:, to:, subject:, is:unread, has:attachment).
- For sending with body content, pass the body directly or pipe a file.
- Both tools require prior authentication setup.

## Notes

- `gog` requires Google OAuth configured via `gog auth`.
- `himalaya` requires IMAP credentials in `~/.config/himalaya/config.toml`.

© daxaur · MIT · daxaur/openpaw

Similar skills

All skills for Notes, tasks and projects →

From the same set41

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor