Mail.ru read-only mail MCP server
Mail.ru MCP
A small read-only MCP server for Mail.ru mail: listing, reading, searching and folders, with no ability to send or delete
- 0 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Runs a Python server that reads Mail.ru email over IMAP with an app password
- The mail_mark_all_read tool changes the mailbox state
- There is no sending or deleting of email
Install
- Works in
- Services
Manual install
python -m pip install .Install from the cloned repository into a virtual environment.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Runs a Python server that reads Mail.ru email over IMAP with an app password
- The mail_mark_all_read tool changes the mailbox state
- There is no sending or deleting of email
This is third-party code. Review the repository files before installing.
What it does
The server connects to Mail.ru mail over TLS IMAP and gives an agent seven tools: listing recent or unread messages, reading one message by a stable IMAP UID with an option not to mark it as read, searching by subject or sender, listing folders, marking all messages in a folder as read, and counting all and unread messages in one folder or across all configured folders. The only tool that changes mailbox state is mail_mark_all_read; sending and deleting mail are not implemented at all.
Who it is for. For people who want to give an agent safe, read-only access to Mail.ru mail with no risk of sending or deleting messages.
Good fit when
- You want an overview of unread mail with no risk of accidentally sending or deleting anything
- You want to find a message by subject or sender and read it without changing its read status
- You want a message count across several folders at once
Not a fit when
- You need to send or delete mail: the server deliberately does not do this
- You need bulk folder sorting or archiving: there are no such tools here
Example request
Find the last ten messages with invoice in the subject and do not change their read statusMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
MAILRU_EMAILrequired- Full mailbox address used for IMAP authentication.
MAILRU_APP_CREDENTIALrequired, secret- App-specific credential created in Mail.ru account settings.
MAILRU_FOLDERS- Comma-separated folders for mail_count_all, defaults to INBOX.
Limitations
The project has a single author, is very small, with no releases or PyPI packaging, and installs from source. It needs separate app-specific credentials, not the main Mail.ru account password. Message bodies are truncated to 4000 characters.
How to disable. Remove the mailru entry from your MCP client config.
FAQ
Can the server send mail?
No, sending and deleting mail are not implemented; it only reads and organizes reading.
Does reading a message change its status?
By default mail_read marks a message as read, but mark_read=false preserves its original status.
Discussion
No questions or reviews yet.
Related
All Mail.ru toolsMail.ru mail MCP server
mailru-mcp
An MCP server for Mail.ru mail: reading, search, folder sorting and archiving that works around Mail.ru's IMAP quirks
Mail.ru MCP server
Mail.ru MCP Server (Go Production Edition)
A Go MCP server for Mail.ru mail, SMTP and cloud storage that requires human confirmation before sending mail or changing files
Email MCP: Yandex, Mail.ru and other providers
Email MCP Server
An HTTP/SSE wrapper around an IMAP MCP server for remote mailbox access from Claude Web: read, search, send, across 15 providers
Mail.ru MCP server and Telegram notifier
Mail Agent
An MCP server for Mail.ru email in Claude.ai, plus a separate Telegram bot that checks the inbox every 15 minutes and alerts on important messages
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
imap-mcp-server: email over IMAP and SMTP for agents
imap-mcp-server
An MCP server for searching, reading, sending and cleaning up email in several mailboxes, with credentials stored under AES-256
README in short
The English and Russian README describes the seven tools, Python and credential requirements, installation via pip, a table of environment variables, a sample .mcp.json config, and a security section: TLS for every connection, credentials only from environment variables, reading marks a message as read by default.