webmail-mcp
Provides calendar event extraction and event creation support; on non-Mac systems, generates an .ics file and a Google Calendar link to add events.
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.
webmail-mcp
Your IIT Delhi mailbox, in the AI assistant you already use.
Connect once. ChatGPT, Claude, Gemini, Cursor, or any other MCP client can read your institute mail and send from it. The mail password stays on the machine that runs this server. The assistant only gets a token.
The hosted site is webmail-mcp.ariesiitd.com. This repository is the same program, for people who want to run it themselves.
MIT licensed.
Self-host
You need Python 3.11 or newer.
git clone https://github.com/rizzhubsane/webmail-mcp
cd webmail-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
webmail-mcp init
webmail-mcp connector iitd --username YOUR_KERBEROS_ID
webmail-mcp enable-send
webmail-mcp token create --name mine --scope read --scope draft --scope sendconnector iitd asks for the webmail password in the terminal. It checks the password with IIT Delhi mail, then stores it encrypted under ~/.assistant-bridge. That directory is mode 0700. master.key is mode 0600. The token is printed once. The disk keeps a hash of it.
Do not type the mail password into a chat. Do not commit master.key, vault.json, accounts.json, oidc.json, or a token.
Point the assistant at the local process. An example is in config/mcp.example.json.
webmail-mcp mcpwebmail-mcp serve listens on 127.0.0.1 only. Binding 0.0.0.0 is refused unless the process is running as an Azure web app.
A demo inbox needs no mail password:
webmail-mcp init
webmail-mcp connector mock
webmail-mcp token create --name demo --scope read --scope draftRelated MCP server: Mailoo
What it can do
The assistant calls these tools. You talk normally.
You ask | Tool |
What came in? |
|
Find the mail I sent |
|
Draft a reply |
|
Send it |
|
Mail this professor |
|
Show the thread |
|
Put it on my calendar |
|
When you say send, it sends. A leftover [placeholder] still blocks the send. Adding an event to the Mac Calendar app works on a Mac. Everywhere else you get an .ics file and a Google Calendar link.
read can look at mail. draft can write a draft. send can transmit it. Create the token with only the scopes you want.
Tests
pytestThe tests do not contact IIT Delhi mail servers.
Privacy
On the hosted site, the mail password is stored encrypted for your Kerberos id. DevClub sign-in confirms who you are. It does not hand over the mail password. The assistant never receives the password.
If you self-host, that password stays on your computer.
Details for the hosted site are at webmail-mcp.ariesiitd.com/privacy.
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
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email and optional phone for AI agents: send, receive, search, draft and call over MCP.
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Give AI agents their own email inboxes: list, read and send mail via scoped, revocable OAuth grants.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables users to manage email accounts via IMAP/SMTP, including reading, searching, sending emails with attachments and calendar invites, all through natural language interactions with MCP-compatible clients.136 PyPI4MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to read, search, send, manage, schedule, and analyze emails across multiple IMAP/SMTP accounts via MCP, with features like OAuth2, calendar extraction, analytics, and real-time email watching.221 npmLGPL 3.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants and MCP clients to manage multiple email accounts, including searching, reading, sending, replying to, forwarding, organizing, and bulk-deleting messages across IMAP/SMTP, with encrypted credential storage and connection pooling.1,009 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search, read, send, reply to, forward, organize, and bulk-delete email across multiple IMAP/SMTP mailboxes, with AES-256-encrypted credential storage, connection pooling, and folder management. Supports 15+ pre-configured providers and simultaneous multi-account access from any MCP client.1,009 npmMIT