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 explorerVerify the DLL is registered:
Get-ItemProperty -Path "HKLM:\SOFTWARE\Clients\Mail\go-mapi" -ErrorAction SilentlyContinueIf 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:
- Sign in with the intended Gmail or Google Workspace account
- Check that the requested Gmail access is authorized
- 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.logRuntime 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\