CoolUtils Mail Viewer
About
Read, convert, and extract attachments from .eml, .msg, .p7m and 9 other email file formats. Built into Mail Viewer for Windows.
Details
- Author
- alexbuzaev75
- Categories
- Communication, Automation, Other
Jump to
Setup
Install CoolUtils Mail Viewer in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/alexbuzaev75/mcp-server-mailviewer
Follow the installation instructions in the repository README, then restart your MCP client.
The server isbuilt intoCoolUtils Mail Viewer— there is nothing extra to install. RunMailViewer.exe --mcpand the program skips its GUI to act as a stdio JSON-RPC server.
Once connected, give your AI assistant natural-language instructions:
- "Convert all .msg files inD:\archiveto PDF and put them inD:\output"— the agent callsconvert_mailon each file.
- "What attachments does this EML have and who sent it?"—get_mail_inforeturns a clean JSON object instantly.
- "Extract all attachments from these 40 emails intoC:\attachments"—extract_attachmentssaves them all in one pass.
Everything runs locally — your mail files are never uploaded anywhere.
Converts a mail file to the specified output format using the full Mail Viewer rendering engine.
- Source formats:.eml,.msg,.mim,.p7m,.vmbx,.tnef,.mapixml,.olk15,.vcf,.contact,.3uc
- Output formats:pdf,html,txt,doc,rtf,tiff,jpg,png,bmp,emf,eml,xps
PDF and DOCX output preserves embedded HTML, inline images, attachment previews, and message headers — identical to what you see in the GUI.
Reads a mail file and returns its metadata as JSON: sender, To/CC/BCC recipients, subject, date, raw RFC headers, plain-text and HTML body, and a list of attachments with names, sizes, and content types.The source file is not modified.
Saves all attachments from a mail file into a target folder (created automatically if it does not exist). Returns the list of saved files with absolute paths and sizes in bytes.
Full input/output schemas:schemas/mcp-tools.json.
Download and installCoolUtils Mail Viewerfor Windows fromhttps://www.coolutils.com/MailViewer. The MCP server is bundled inside the standardMailViewer.exebinary — no extra package, no separate license.
A 30-day free trial is available; no email or credit card is required.
Add to~/.claude.jsonundermcpServers:
{ "mcpServers": { "mailviewer": { "command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe", "args": ["--mcp"] } } }
Add to%APPDATA%\Claude\claude_desktop_config.jsonundermcpServers(same block as above).
Add to.cursor/mcp.jsonin your project, or to~/.cursor/mcp.jsonglobally — same JSON block.
Open Cline's MCP settings UI and paste the same block.
A copy-paste-ready snippet is also installed alongside the executable asclaude-config-snippet.json. Adjust the path if you installed Mail Viewer in a non-default location.
Run this in a command prompt to confirm the server responds:
echo {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}} | "C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe" --mcp
You should see a single JSON-RPC response containingprotocolVersion,serverInfo, and atoolscapability.
Seeexamples/usage.mdfor end-to-end transcripts:
- Batch convert a folder— point Claude at a directory of.msgfiles and ask for PDFs.
- Forensic triage— ask Claude to summarize sender/subject/attachment patterns across 100 emails.
- Attachment harvesting— extract every attachment from a quarter's worth of legal correspondence into one folder.
- Transport:stdio (NDJSON, one JSON-RPC 2.0 message per line, UTF-8)
- Protocol version:2024-11-05
- Server name(reported ininitialize):mailviewer-mcp
- Platform:Windows 7 / 8 / 10 / 11
- License:Commercial (Mail Viewer); MIT (this configuration/docs repo). Personal license starts at $49.90, 30-day free trial.
Server manifest:schemas/mcp-server.json.
The server doesn't respond.Verify the executable path is correct. The default install path on Windows isC:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe. On 32-bit installs useC:\Program Files (x86)\….
Claude can't find the tools.Restart your MCP client after editing the config file. Check the client logs — for Claude Desktop, see%APPDATA%\Claude\logs.
File path errors.Use absolute paths in your prompts. Forward slashes (/) and backslashes (\) both work; quote paths with spaces.
Trial expired.Buy a license— Personal starts at $49.90. The MCP server keeps working in the same binary.
- Mail Viewer product page
- MCP article on coolutils.com
- Model Context Protocol specification
- CoolUtils support
The configuration files, schemas, and documentation in this repository are released under theMIT License. CoolUtils Mail Viewer itself is commercial software — see the product page for licensing.
Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.
Turn AI tools into your email marketing assistant.
Turn an AI tool into your smart email engine
Connect your AI assistant to Onboard to monitor live onboarding projects, surface blocked tasks and risks, draft customer emails, and take action on tasks with role-based access and preview-first safety.
Send and receive emails, SMS, and voice calls via Pingram.
Send emails directly from your editor using the Resend API.
Sendmux is an email inbox API and email API for AI agents.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
