GrokBot Mail.com Plugin

⚠️ Requires mail.com Premium — will NOT work on a free mailbox. Mail.com locks POP3/IMAP and email forwarding behind Premium, and offers no public API. This connector talks to the mailbox over IMAP/SMTP, so a free account simply has nothing for it to connect to. There is no workaround short of upgrading (or pointing the server at a different provider's IMAP/SMTP via env vars — Gmail works).

Status: archived for the above reason. Kept for reference.

Mail.com connector for GrokBot, as an MCP server. Mail.com has no public REST API, so this wraps the official mailbox protocols:

• IMAP imap.mail.com:993 (SSL)

• SMTP smtp.mail.com:587 (STARTTLS, or 465 SSL)

Tools: check_connection, list_folders, folder_stats, list_emails, search_emails, read_email, download_attachment, send_email, reply_email, mark_read, delete_email. Plus a mail-support skill for project/support triage.

1. Enable IMAP in mail.com

In the webmailer, click the gear icon (bottom-left, under the folder list) -> Settings -> POP3 & IMAP -> Enable access via POP3 and IMAP -> Save. Login elsewhere is your full address (e.g. ColinKenny@programmer.net).

Related MCP server: Email Server

2. Run locally

pip install -r requirements.txt
copy .env.example .env   # fill in MAILCOM_EMAIL + MAILCOM_PASSWORD
python server.py         # stdio mode

Self-host HTTP mode:

$env:MCP_TRANSPORT="streamable-http"; $env:MCP_PORT="8000"; python server.py
# endpoint: http://localhost:8000/mcp

Or Docker: docker build -t mailcom-mcp .; docker run -p 8000:8000 --env-file .env mailcom-mcp

3. Add to GrokBot (personal use, easiest)

GrokBot runs on a cloud computer — add the server in chat, not a config file. Push this repo to GitHub first, then tell your bot:

Add a custom MCP server called mailcom that runs:
python /path/to/server.py
with env vars MAILCOM_EMAIL and MAILCOM_PASSWORD (ask me for them as secrets).

Or if you self-host: Add a custom MCP server called mailcom at https://your-host/mcp.

Then: Settings -> Plugins -> Yours -> mailcom, attach with @mailcom in chat.

Your bot was right: connectors are just MCP servers packaged as plugins — plugin.json + mcp.json/​.mcp.json + skills/ is that packaging here.

4. Publish to marketplace (optional)

1. Push this repo public.

2. Submit at cursor.com/marketplace/publish (Agent Plugins layout).

3. Review is manual; updates re-reviewed.

Security notes

• Never commit .env or real credentials (see .gitignore).

• Sending/deleting are side effects — the skill requires confirmation first.

• Prefer mark_read over delete_email.