Troubleshooting

“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.

Installer Can’t Find the Extension  

The installer auto-detects the extension ID from your browser profiles. If it fails:

1. Confirm the extension is installed: Check chrome://extensions or edge://extensions
2. Make sure the browser isn’t running as admin — user profile paths differ
3. Specify the ID manually:

.\install.ps1 -ExtensionId "your-32-character-extension-id"

You can find the extension ID in chrome://extensions (enable Developer mode to see it).

Extension Popup Doesn’t Appear  

• Check the extension is enabled in chrome://extensions or edge://extensions
• Click the extension icon in the browser toolbar — you may need to pin it
• Check the browser console for errors: right-click the extension icon → “Inspect popup”

Gmail Authorization Fails  

go-mapi uses Chrome’s Identity API for OAuth. If authorization fails:

1. Sign in to Chrome/Edge with your Google account
2. Check that the Gmail API scope is authorized: the extension will prompt you on first use
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 (Native Host)  

The native messaging host logs to:

%LOCALAPPDATA%\go-mapi\logs\

Extension Logs  

Open the browser DevTools for the extension:

1. Go to chrome://extensions or edge://extensions
2. Find go-mapi → click “Inspect views: service worker”
3. Check the Console tab for errors

Still Stuck?  

Open an issue on GitHub  with:

• Your Windows version
• Browser and version
• Installation log (C:\Program Files\go-mapi\install.log)
• Any error messages from the extension console