SkillFoxx

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

  • 0 ★ on the repository
  • Last commit
MCP server

Broad access

Why this level

  • The send_reply tool sends emails via SMTP on behalf of the mailbox owner
  • The Mail.ru app password sits in Railway environment variables in plain text with no secrets manager
All reasons and checks
Russian stack

garrik24/mail-agentAuthor:Garrik24

Install

Manual install

Text for your agent

Deploy mcp-server as a Railway service with Root Directory mcp-server and the MAIL_IMAP_HOST, MAIL_SMTP_HOST, MAIL_USERNAME and MAIL_PASSWORD (a Mail.ru app password) variables, generate a domain, then in Claude.ai go to Settings, MCP Servers and add https://<domain>.up.railway.app/mcp.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The send_reply tool sends emails via SMTP on behalf of the mailbox owner
  • The Mail.ru app password sits in Railway environment variables in plain text with no secrets manager

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

What it does

The repository provides two independent services. An MCP server on FastMCP and Streamable HTTP exposes 7 tools for Mail.ru email over IMAP and SMTP: new emails in the last N hours, emails flagged Important, search by text, sender and date, full message content, structured data for analysis, replying to an email via SMTP, and listing mailbox folders. A Telegram notifier runs as a background worker, checking mail via IMAP every 15 minutes, classifying messages into categories (urgent: government bodies like Rosreestr and the tax service; important: finance and contracts; lead: commercial proposals and tenders), running them through Claude for analysis, and sending a Telegram alert, deduplicating already-sent messages via SQLite. Both services are meant to be deployed on Railway as separate services.

Who it is for. For Mail.ru email owners who want access to their inbox from Claude.ai and instant Telegram alerts on important messages.

Good fit when

  • You want to read, search and reply to Mail.ru email right from the Claude.ai chat
  • You want Telegram alerts on emails from government bodies, finance or new leads without constantly checking mail
  • You are ready to deploy two services on Railway and store a Mail.ru app password in environment variables

Not a fit when

  • You don't want to store an email app password in cloud-hosting environment variables: the services read it plainly from ENV
  • You need email other than Mail.ru: the IMAP and SMTP addresses are hardcoded to imap.mail.ru and smtp.mail.ru
  • You don't want an always-on background process: telegram-notifier is built to run continuously on a check interval

Example request

Show new emails from the last 6 hours and reply to the accounting email confirming the invoice was paid

MCP

Transport
http
Authentication
not required

Environment variables

MAIL_USERNAME required
Mail.ru mailbox address
MAIL_PASSWORD required, secret
Mail.ru app password for IMAP and SMTP

Limitations

The repository has no license. The Mail.ru email password (an app password) is stored in Railway environment variables in plain text, with no secrets manager. The repo includes a folder of ready commercial proposal templates and real company logos (Gazprom, Magnit, Rostelecom and others) for its proposal-generation tool, worth noting before forking for your own use.

How to disable. Delete or stop both services in Railway, revoke the Mail.ru app password, and remove the MCP server from Claude.ai's settings.

FAQ

Do I need my regular mail password or an app password?

The README specifies a Mail.ru app password, which has to be created separately in the account's security settings, not the main account password.

Are both services required?

No, the MCP server and the Telegram notifier are independent, and you can deploy just one of them.

Discussion

No questions or reviews yet.

All Mail.ru tools
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 access2
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

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 access1

MCP Telegram for reading: the agent gets your account's dialog list and unread messages over MTProto and has no way to write on your behalf

MCP serverBroad access190

MCP Telegram with write access: the agent sends, edits and deletes messages, searches chats, keeps drafts and downloads media in your account over MTProto

MCP serverBroad access252

README in short

The Russian README describes the structure of the two services, a step-by-step Railway deployment including creating a GitHub repo, environment variables for each service, connecting the MCP to Claude.ai via a URL, a table of the 7 MCP tools, and a table of the Telegram notifier's email classification categories by urgency.

README badge

Report a problem