Mail (mail.ru) mcp server with IMAP,SMTP, WEBDAV, CALDAV

Python MCP server for IMAP/SMTP email, WebDAV, and CalDAV for mail.ru services

Package Run

Publish the package to PyPI as mcp-email-webdav-caldav, then run it without cloning this repository:

Get external app password here (choose all protocols) https://account.mail.ru/user/2-step-auth/passwords

Update package

uv tool upgrade mcp-email-webdav-caldav

For Claude:

claude-glm-5 mcp add --scope user mail-webdav-caldav \
--env 'MCP_SERVER_FULL_NAME=Иван Иванов' \
--env MCP_SERVER_EMAIL_ADDRESS=ivan@inbox.ru \
--env MCP_SERVER_PASSWORD=token \
-- uvx mcp-email-webdav-caldav

For Codex:

[mcp_servers.mail-webdav-python]
command = "uvx"
args = ["mcp-email-webdav-caldav"]
enabled = true

[mcp_servers.mail-webdav-python.env]
MCP_SERVER_FULL_NAME = "Jane Doe"
MCP_SERVER_EMAIL_ADDRESS = "jane@example.com"
MCP_SERVER_PASSWORD = "app_password_here"

Equivalent one-off run:

uvx mcp-email-webdav-caldav

Or install the package once and run the console script:

pipx install mcp-email-webdav-caldav

Then Codex can use:

command = "mcp-email-webdav-caldav"
args = []

Ready-made examples:

• Codex uvx config
• Codex installed-script config

Build And Publish

Build source and wheel distributions:

uv build

Publish to PyPI:

uv publish

Runtime Environment Variables

Required:

• MCP_SERVER_FULL_NAME
• MCP_SERVER_EMAIL_ADDRESS
• MCP_SERVER_PASSWORD

MCP_SERVER_EMAIL_ADDRESS and MCP_SERVER_PASSWORD are reused as credentials for Email, WebDAV, and CalDAV.

Service Constants

Provider-specific settings live in src/mcp_email_webdav_caldav/constants.py:

• Email IMAP/SMTP host, port, SSL, sent-folder, and attachment-download settings.
• WebDAV account name, base URL, description, download, and upload settings.
• CalDAV account name, base URL, well-known discovery, and write settings.

CalDAV uses /.well-known/caldav discovery by default. The client follows redirects, reads current-user-principal, then reads calendar-home-set and performs calendar/event operations relative to that discovered calendar-home URL.

TLS certificate verification is always disabled; connections use an unverified SSL context.

Accounts are configured entirely through the MCP_SERVER_* environment variables together with constants.py — one account each for Email, WebDAV, and CalDAV. There is no on-disk config file.

Tools

Email:

• list_available_accounts
• list_mailboxes
• list_emails_metadata
• get_emails_content
• send_email
• delete_emails
• download_attachment

WebDAV:

• list_webdav_accounts
• webdav_list
• webdav_get_text
• webdav_download_file
• webdav_put_text
• webdav_upload_file
• webdav_mkdir
• webdav_delete
• webdav_move
• webdav_copy

CalDAV:

• list_caldav_accounts
• caldav_list_calendars
• caldav_list_events
• caldav_check_availability
• caldav_get_event
• caldav_put_event
• caldav_create_event
• caldav_delete_event

list_emails_metadata returns mailbox together with each email_id; pass the same mailbox to get_emails_content, delete_emails, and download_attachment. Set all_mailboxes=true to search every selectable IMAP folder.

webdav_download_file and webdav_upload_file are disabled by default because they read/write local files. Enable them explicitly in constants.py.

Sent email is uploaded to IMAP after SMTP send when EMAIL_SAVE_TO_SENT is enabled. Leave EMAIL_SENT_FOLDER_NAME empty to auto-detect the IMAP mailbox with the \Sent flag, which is the right mode for localized folders such as Mail.ru Отправленные. The send_email response includes sent_copy with the mailbox used for the saved copy.

caldav_put_event, caldav_create_event, and caldav_delete_event are disabled by default because they modify remote calendars. Enable them explicitly in constants.py.

caldav_create_event accepts attendees as attendees = ["Name <user@example.com>", "other@example.com"]. The participants field is accepted as an alias. The server writes standard ORGANIZER / ATTENDEE iCalendar fields. Use caldav_check_availability before creating a meeting to check whether the selected calendar has busy items in the requested time range.

Test

PYTHONPATH=src python3 -m unittest discover -s tests