Docs

Troubleshooting

Common issues and their solutions when using go-mapi.

“Send to → Mail recipient” Does Nothing  

Restart Windows Explorer after installation. The DLL is loaded when Explorer starts, so a restart (or reboot) is required.

To restart Explorer without rebooting:

Stop-Process -Name explorer -Force
Start-Process explorer

Verify the DLL is registered:

Get-ItemProperty -Path "HKLM:\SOFTWARE\Clients\Mail\go-mapi" -ErrorAction SilentlyContinue

If the key doesn’t exist, re-run the installer.

Gmail Compose Doesn’t Open  

  • Confirm the go-mapi desktop app is running after installation
  • Restart Windows Explorer or reboot so Explorer loads the registered mail handler cleanly
  • Check runtime logs in %LOCALAPPDATA%\go-mapi\logs\

Gmail Authorization Fails  

If Gmail asks you to sign in or authorize access:

  1. Sign in with the intended Gmail or Google Workspace account
  2. Check that the requested Gmail access is authorized
  3. For Google Workspace: your admin may need to approve the app in the Google Admin Console

Logs  

Installation Logs  

C:\Program Files\go-mapi\install.log

Runtime Logs  

The desktop app logs to:

%LOCALAPPDATA%\go-mapi\logs\

Still Stuck?  

Open an issue on GitHub  with:

  • Your Windows version
  • Installation log (C:\Program Files\go-mapi\install.log)
  • Runtime logs from %LOCALAPPDATA%\go-mapi\logs\