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
MCP server

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
All reasons and checks
Russian stack

drseedon/mailru-mcp

Install

Services

Manual install

python -m pip install .

Install from the cloned repository into a virtual environment.

Access and checks

How we review

Broad 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 status

MCP

Transport
stdio
Authentication
API key

Environment variables

MAILRU_EMAIL required
Full mailbox address used for IMAP authentication.
MAILRU_APP_CREDENTIAL required, 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.

Russian stack

An MCP server for Mail.ru mail: reading, search, folder sorting and archiving that works around Mail.ru's IMAP quirks

MCP serverExtended access2Repository stars

Mail.ru MCP server

Mail.ru MCP Server (Go Production Edition)

Russian stack

A Go MCP server for Mail.ru mail, SMTP and cloud storage that requires human confirmation before sending mail or changing files

MCP serverBroad access1Repository stars
Russian stack

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

MCP serverBroad access
Russian stack

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

SkillMinimal access2Repository stars

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.

README badge

Report a problem