Download & Install

System Requirements  

• Windows 10 or 11 (x64)
• Google Chrome or Microsoft Edge
• Gmail or Google Workspace account
• Admin rights for the native host installer

Step 1: Install the Browser Extension  

Install the go-mapi extension in your browser:

    Or load unpacked from a [GitHub release](https://github.com/marcfargas/go-mapi/releases).

    Or load unpacked from a [GitHub release](https://github.com/marcfargas/go-mapi/releases).

Enterprise deployment? Force-install the extension via Chrome/Edge ExtensionInstallForcelist  policy. See Enterprise Deployment.

Step 2: Run the Installer  

Open an admin PowerShell and run:

irm https://raw.githubusercontent.com/marcfargas/go-mapi/main/scripts/install.ps1 | iex

The installer will:

1. Auto-detect the extension ID from your browser profiles
2. Download the latest release from GitHub
3. Install binaries to C:\Program Files\go-mapi\
4. Register the MAPI handler in Windows
5. Set up native messaging for Chrome and Edge

That’s it. Right-click any file → “Send to” → “Mail recipient” → Gmail.

Advanced Installation  

# Fully automated (no prompts, for CI/automation)
.\install.ps1 -Unattended

# Pin a specific version
.\install.ps1 -Version "v1.0.0"

# Custom install directory
.\install.ps1 -InstallDir "D:\go-mapi"

# Manually specify extension ID (if auto-detection fails)
.\install.ps1 -ExtensionId "abcdefghijklmnopqrstuvwxyz123456"

# Developer: install from local build instead of GitHub
.\install.ps1 -Local

Uninstall  

# Full uninstall (admin PowerShell)
.\install.ps1 -Uninstall

# Registry-only (keep files)
.\install.ps1 -Uninstall -KeepFiles

The uninstaller removes all registry entries and restores your previous default mail client.

Verify Installation  

After installation, verify everything works:

1. Open Windows Explorer
2. Right-click any file → “Send to” → “Mail recipient”
3. The go-mapi extension popup should appear with the file attached
4. Click “Save as Draft” or “Send Now”

Having issues? Check the Troubleshooting guide.