SkillFoxx

Type a name, a task or a service

Yandex Mail MCP

Yandex Mail MCP Server

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

MCP serverHigh riskRussian stack

gdigora/yandex-mail-mcpAuthor: gdigora

Install

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

First clone github.com/gdigora/yandex-mail-mcp and enter the folder. Put your Yandex Mail address and app password into .env.

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

What it does

The server connects the agent to a Yandex Mail inbox over IMAP and SMTP with an app password. The agent sees folders with properly decoded Russian names and searches mail by sender, subject, date or a raw IMAP query, Cyrillic included. It can read a full message, save an attachment to disk, send plain text or HTML mail, move a message to another folder or put it in the trash.

Who it is for. For people who run work correspondence in Yandex Mail and want an agent to help process it.

Good fit when

  • You need to find messages by sender or subject and summarize them
  • You need to save attachments from mail to a folder
  • You need to send a message drafted with the agent

Not a fit when

  • The agent must not send or delete mail without review
  • Your mail is hosted by another provider, not Yandex

Example request

Find unread messages from accounting this week and save their attachments to Downloads

Limitations

It needs two-factor authentication in Yandex ID and a separate mail app password, with login and password stored in a .env file. There is no PyPI package: you clone the repo and run it from a Python virtual environment. The README only shows a Claude Desktop config. The repo has no license file; the README states MIT.

How to disable. Remove the yandex-mail block from claude_desktop_config.json and revoke the app password in Yandex ID.

MCP

Transport
stdio
Authentication
not required

Security check

  • The agent can send mail on your behalf
  • The agent reads private mail and can move and delete messages
  • The app password is stored in plain text in .env

README in short

The README lists seven tools: folders, search, read, attachment download, send, move and delete. Setup is cloning, a Python virtual environment and filling in .env. It explains how to enable two-factor authentication and create an app password. It includes IMAP query examples and the test command.

FAQ

Is mail deleted permanently?

According to the delete_email tool description, the message is moved to the trash.

Why an app password?

Yandex does not let third-party IMAP and SMTP clients use the main password; you create a separate one in Yandex ID security settings.

Editors’ pick

A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more

CLIHigh risk31K
Editors’ pick

Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server

CLIMedium risk29.7K
Editors’ pick

A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI

MCP serverMedium risk28.1K
Editors’ pick

Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search

PluginHigh risk24K