Yandex Mail MCP
Yandex Mail MCP Server
Yandex Mail MCP server over IMAP and SMTP: search and read mail, attachments, send, move and delete
- 8 ★ on the repository
- Last commit
Broad access
Why this level
- 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
Install
- Works in
- Services
Manual install
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .envFirst clone github.com/gdigora/yandex-mail-mcp and enter the folder. Put your Yandex Mail address and app password into .env.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- 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
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 DownloadsMCP
- Transport
- stdio
- Authentication
- not required
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.
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.
Discussion
No questions or reviews yet.
Related
All Yandex 360 toolsYandex Mail MCP server
ymail-mcp
Yandex work mail in Claude Code over IMAP: reading, searching threads and drafting replies without sending
Yandex Mail Digest MCP server
MCP Server: Yandex Mail Digest
An MCP server that reads Yandex Mail for a period and saves a structured digest to a file
Yandex 360 MCP: Disk, Telemost and Messenger
mcp-yandex360
A 28-tool MCP server covering Yandex 360 Disk, Telemost and Messenger in one process
A skill pack for Yandex 360: Mail, Calendar, Contacts, Directory, Telemost, Disk, Forms and Tracker
A single Rust binary: CLI, MCP server and MCP Apps for Yandex Mail, Calendar and Disk, with 13 embedded skills and cross-service workflows
A read-only Yandex Mail MCP connector for ChatGPT via OAuth and IMAP XOAUTH2, with no sending, deleting or changing mail
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.