ovgu-webmail-mcp
Provides read-only access to an OVGU mailbox backed by Roundcube/Cyrus IMAP, enabling folder listing, message listing and searching, and retrieval of message headers, plain-text bodies, and attachment metadata.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ovgu-webmail-mcp
A small, read-only MCP server that lets Claude (or any MCP client) look through your OVGU mailbox.
webmail.ovgu.de is just Roundcube sitting on top of the university's Cyrus IMAP server, so this skips the web page entirely and talks IMAP to cyrus.ovgu.de:993. It can list folders, list and search messages, and read a message. It cannot send, move, delete or mark anything as read. Every fetch uses BODY.PEEK and every folder is opened read-only.
I wrote it to ask things like "what's unread from the Studierendenrat this week?" without opening the browser. It hasn't had much real-world use yet, so expect rough edges.
Setup
You need Python 3.10+ and an OVGU account.
git clone https://github.com/cvcvka5/ovgu-webmail-mcp.git
cd ovgu-webmail-mcp
pip install -r requirements.txtThe SDK is pinned below version 2 because the code uses FastMCP, which mcp 2.x renamed.
Related MCP server: proton-read-mcp
Configuration
The server reads its settings from environment variables.
Variable | Meaning | Default |
| Your OVGU account username | none |
| Your OVGU account password | none |
| IMAP server |
|
| IMAP port (TLS) |
|
One thing that trips people up: the username is your account login, not your e-mail address. OVGU's own setup guides say the same.
Copy .env if you want a template. Don't commit real credentials.
Using it with Claude
Claude Code:
claude mcp add ovgu-webmail \
-e OVGU_IMAP_USER=your_username \
-e OVGU_IMAP_PASSWORD=your_password \
-- python /absolute/path/to/ovgu_webmail_mcp.pyClaude Desktop, in claude_desktop_config.json:
{
"mcpServers": {
"ovgu-webmail": {
"command": "python",
"args": ["/absolute/path/to/ovgu_webmail_mcp.py"],
"env": {
"OVGU_IMAP_USER": "your_username",
"OVGU_IMAP_PASSWORD": "your_password"
}
}
}
}To poke at it without a client, run npx @modelcontextprotocol/inspector python ovgu_webmail_mcp.py.
Tools
All four tools are read-only and accept response_format set to markdown (the default) or json.
webmail_list_folders returns every folder with its message count and unread count.
webmail_list_messages returns headers for a folder, newest first. Options are folder (default INBOX), limit (up to 100), offset for paging, and unread_only.
webmail_search_messages filters a folder by text, from, subject, since, before and unread_only. Filters are combined with AND.
webmail_get_message takes a folder and a UID from the list or search results and returns the headers, the body as plain text (HTML is stripped) and a list of attachments. Bodies are cut off at max_chars, 8000 by default.
Limits
Search supports one non-ASCII term at a time, so "Prüfung" works but "Prüfung" plus "Übung" in the same search does not. Split it into two searches.
Attachment contents are never returned, only names, types and sizes.
Messages over 25 MB are refused. Open those in webmail.
The password lives in plain text in your client config. Use a dedicated password if OVGU offers one, and keep the config file private.
The offline tests use a fake IMAP connection. I haven't verified the server against the live OVGU mailbox from a clean checkout, so if something behaves oddly with real mail, open an issue.
Tests
pip install pytest
pytestLicense
MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Your mailboxes in ChatGPT and Claude: Gmail, iCloud, Fastmail, any IMAP. Passwords stay yours.
Your own IMAP mailbox in any MCP client: search, read, flag, move; send and delete need confirm.
Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables email management through IMAP/SMTP, including reading, sending, replying, starring, deleting, labeling emails, handling attachments, and filtering by Gmail smart categories. Works with MCP-compatible clients like Claude Desktop and Claude Code using App Password authentication.1946 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude to read-only browse, search, and fetch emails from a Proton Mail inbox through Proton Bridge IMAP, with no capabilities to send, move, flag, or delete.MIT
- AlicenseNot gradedqualityBmaintenanceEnables read-only IMAP email access through MCP, including listing accounts and folders, searching messages, retrieving message bodies and attachments, and viewing threads without modifying mail state.MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients and AI assistants to search and read email through read-only IMAP access, including bounded message reads and explicitly selected attachment retrieval.MIT