convert_mailLABSCO SUMMARY
A folder of .msg files becomes something an agent can work through.
Proprietary mail formats are the reason this kind of task is still manual: nothing else opens .msg, .p7m or .olk15 in bulk. The rendering engine here is the one behind the GUI, so a batch conversion produces the same PDFs a person would have made by hand — and the files never leave the machine.
What it is
The MCP server built into CoolUtils Mail Viewer for Windows. Launched with a switch on the command line, MailViewer.exe skips the GUI and turns the program into a stdio JSON-RPC server. Everything runs locally; mail files are not uploaded anywhere.
What you get
- Mail files converted using the full Mail Viewer rendering engine, from .eml, .msg, .mim, .p7m, .vmbx, .tnef, .mapixml, .olk15, .vcf, .contact and .3uc
- Output as pdf, html, txt, doc, rtf, tiff, jpg, png, bmp, emf, eml or xps — PDF and DOCX preserving embedded HTML, inline images, attachment previews and message headers
- A message's metadata returned as JSON: sender, To, CC and BCC, subject, date, the raw RFC headers, both plain-text and HTML bodies, and the attachment list with names, sizes and content types
- Attachments extracted to a folder that is created if it does not exist, returning absolute paths and byte sizes
- Reads that do not modify the source file
Requirements
Windows, with CoolUtils Mail Viewer installed — the MCP server is bundled inside the standard MailViewer.exe binary, so there is nothing extra to install. Full input and output schemas ship in the repository.
Setup effort
Follow the published steps
USE CASES
01
Turning an archive of messages into readable PDFs
Convert a folder of .msg or .eml files to PDF in one pass, with inline images, headers and attachment previews preserved.
02
Finding out who sent something and what came with it
Read the message's metadata as JSON — sender, recipients, subject, date and the attachment list — without opening it in a client.
03
Pulling the attachments out of a stack of emails
Extract everything into one folder and get back the absolute paths and sizes, so the next step can act on real files.
04
Opening a format nothing else will read
.p7m, .tnef, .olk15 and .mapixml are handled by the same converter, so a message that defeated your mail client still yields its contents.
05
Preparing email evidence for a review
Read the raw RFC headers alongside the rendered body, keeping the original file untouched.
3 tools
Listed in project docs. Your client may show a different list.
get_mail_infoextract_attachmentsBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
Download and install CoolUtils Mail Viewer for Windows from https://www.coolutils.com/MailViewer (the MCP server is bundled inside the standard MailViewer.exe — nothing extra to install; 30-day free trial)
Claude Code: add the mcpServers block below to ~/.claude.json
Claude Desktop: add the same block to %APPDATA%\Claude\claude_desktop_config.json
Cursor: add the same block to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global); Cline: paste the same block in its MCP settings UI
Optional check: pipe an initialize JSON-RPC line into MailViewer.exe --mcp and confirm you get a response containing protocolVersion, serverInfo and a tools capability
MCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"mailviewer": {
"command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe",
"args": [
"--mcp"
]
}
}
}
