SkillFoxx

IMAP mail reading skill

imap-client

A skill for reading and searching email over IMAP via the myl CLI: Gmail, Yandex Mail, Mail.ru, autodiscovery for others

  • 2 ★ on the repository
  • Last commit
  • MIT
Skill

Minimal access

Why this level

  • It only reads mail through a read-only client; sending and folder changes are out of scope
All reasons and checks
Russian stack

codd-tech/imap-clientAuthor:codd-tech

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/imap-client

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • It only reads mail through a read-only client; sending and folder changes are out of scope

This is third-party code. Review the repository files before installing.

What it does

The skill teaches the agent when and how to use myl, a small read-only IMAP CLI client, to check the inbox, search messages and download attachments from the terminal. It ships ready IMAP_PROVIDER shortcuts for Gmail, Yandex Mail including Yandex 360 for Business addresses, and Mail.ru with the mail.ru, bk.ru, inbox.ru and list.ru domains, with autodiscovery or manual server setup for other providers. Credentials come only from the environment or a file with 600 permissions, never asked for mid-conversation, and SKILL.md's own description explicitly excludes sending mail, SMTP or composing: read only.

Who it is for. For people who want to check and search Yandex, Mail.ru or Gmail email right from an agent chat, without opening a mail client.

Good fit when

  • You want to check new mail or find a specific email by asking the agent
  • You want to download an attachment from an email without opening a mail client
  • You want support for several mail providers at once with ready settings

Not a fit when

  • You need to send or reply to an email: the skill is deliberately read-only
  • You need folder management, flags or other mailbox state changes

Example request

Check my Yandex mail and find the email from the tax office from the last month

Limitations

You need the myl CLI installed and an app-specific password from the mail provider; a regular account password does not work for most services. The skill itself refuses to read the credentials file if its permissions are not 600 or 400. It is read-only; sending mail and folder management are out of scope.

How to disable. Remove the imap-client folder from your skills directory, e.g. ~/.claude/skills/imap-client, and delete the IMAP_USER and IMAP_PASSWORD variables from your environment.

FAQ

Can the skill send an email on my behalf?

No, myl only reads mail; sending and SMTP are deliberately out of scope.

Will my regular Yandex Mail password work?

No, you need a separate app-specific password from the mail account's security settings.

Discussion

No questions or reviews yet.

All Yandex 360 tools
Russian stack

Yandex work mail in Claude Code over IMAP: reading, searching threads and drafting replies without sending

MCP serverBroad access

Yandex Mail MCP

Yandex Mail MCP Server

Russian stack

Yandex Mail MCP server over IMAP and SMTP: search and read mail, attachments, send, move and delete

MCP serverBroad access8
Russian stack

A skill pack for Yandex 360: Mail, Calendar, Contacts, Directory, Telemost, Disk, Forms and Tracker

SkillBroad access12

Yandex Mail Digest MCP server

MCP Server: Yandex Mail Digest

Russian stack

An MCP server that reads Yandex Mail for a period and saves a structured digest to a file

MCP serverExtended access
Russian stack

A small read-only MCP server for Mail.ru mail: listing, reading, searching and folders, with no ability to send or delete

MCP serverBroad access

README in short

The README lists providers with ready shortcuts, gives a quick start covering installing myl, getting an app password, installing the skill via ClawHub or git clone, and three credential setup methods for OpenClaw, Claude Code and headless scenarios with a file-permission check.

README badge

Original SKILL.md

---
name: imap-client
description: 'Read, search, and download email over IMAP from the command line using the myl CLI client. Use this skill whenever the user wants to interact with their mailbox from a terminal, checking the inbox, listing or searching messages, reading a specific email, opening HTML or raw source, or saving attachments. Do not trigger for outgoing mail (sending, SMTP, drafting), myl is read-only, or for desktop/GUI mail clients.'
license: MIT
---

# imap-client

Read mailboxes over IMAP from the terminal using myl, a small Python CLI client. myl is read-only and intentionally minimal: it lists, searches, and fetches messages and attachments. It does not send mail, manage folders, or modify state beyond optional read-marking.

Report a problem