Install with the installer

Download one file, run it, and your mailbox is wired into Claude.

Install with the installer

Download the installer for your system from the changelog or the latest release and run it:

SystemFile
Windowsrubit-mcp-mail-setup-windows.exe
Linuxrubit-mcp-mail-setup-linuxchmod +x it first
There is no macOS installer. On macOS, follow Install from source.

Nothing needs to be installed beforehand: Python and every dependency are inside that one file. A window asks for your provider and email address, signs you in, and registers the mail server with Claude Desktop and Claude Code if it finds them — restart Claude Desktop afterwards and your mail is there.

On Linux

chmod +x rubit-mcp-mail-setup-linux
./rubit-mcp-mail-setup-linux

Afterwards

It also leaves you a rubit-mcp-mail Settings shortcut — Start Menu and Desktop on Windows, the application menu on Linux — which opens the settings window for anything you want to change later. No terminal, at any point.

Run the installer again whenever you want to add a second mailbox or repair a sign-in; it updates what is already configured rather than replacing it. On a machine with no desktop (over SSH, say) the same file walks you through it in the terminal.

A note on antivirus warnings

Windows Defender or Avast may flag this .exe. This is a known false positive common to unsigned PyInstaller-built applications — an antivirus heuristic reacting to the pattern of a bundled Python runtime, not anything this project's code actually does.

Proper code-signing is the durable fix and is tracked as a follow-up, not done yet. In the meantime: report it to your antivirus vendor as a false positive (Avast has a submission form for this), or build from source and compare against what's published here. Every published installer's SHA-256 is listed on the changelog so you can verify what you downloaded.