Word Integration Setup¶
Recall integrates with Microsoft Word to let you insert pinned excerpts, citations, and generate Table of Authorities directly in your documents.
Platform-Specific Integration¶
macOS¶
On macOS, you choose between two integration modes:
Recommended Mode (Apple Events)¶
This is the simpler option and works for most users.
How it works: Recall communicates with Word using macOS Apple Events (the same technology used for AppleScript automation).
Setup:
- Select Recommended (Apple Events) in the setup wizard
- Click Request Word Permission
- A system dialog appears: "Recall wants to control Microsoft Word"
- Click OK or Allow to grant permission
- Click Next to continue
The permission request result (granted or denied) is shown clearly in the setup wizard.
Requirements:
- Microsoft Word for Mac installed
- macOS automation permissions granted to Recall
Advanced Mode (Word Add-in)¶
For users who need the Word Add-in integration method.
How it works: Recall runs a local HTTPS server and installs a Word Add-in that communicates over a secure localhost connection.
Setup:
- Select Advanced (Word Add-in) in the setup wizard
- Generate the security certificate
- Trust the certificate in Keychain Access
- Install the Word Add-in
Windows¶
On Windows, Word integration uses COM automation and is configured automatically. No additional setup steps are needed — just make sure Microsoft Word is installed.
Advanced Mode: Certificate Setup (macOS)¶
The Advanced mode requires a trusted certificate for secure communication between Recall and Word.
Generating the Certificate¶
- Click Generate Certificate in the setup wizard
- Recall creates a self-signed certificate for localhost connections
- The certificate is stored in your system keychain
Trusting the Certificate¶
After generating the certificate, you need to mark it as trusted:
- Open Keychain Access (Applications → Utilities → Keychain Access)
- Find the Recall certificate in the login keychain
- Double-click the certificate to open its details
- Expand the Trust section
- Set When using this certificate to Always Trust
- Close the window and enter your password to confirm
Installing the Word Add-in¶
Once the certificate is trusted:
- Quit Microsoft Word if it's running
- Click Install Add-in in the setup wizard
- Restart Microsoft Word
- The Recall add-in should appear in Word's ribbon
Troubleshooting¶
Word integration not working¶
- Check that Microsoft Word is running
- Verify the status indicator in Recall's status bar shows Word is connected
- Try the Test Connection button in settings to diagnose issues
Permission popup won't appear (macOS Recommended mode)¶
- Click Request Word Permission in the setup wizard Word step
- If no popup appears, open System Settings → Privacy & Security → Automation
- If Recall isn't listed, try inserting a pin into Word — the popup should appear on first use
Permission denied (macOS Recommended mode)¶
- Open System Settings → Privacy & Security → Automation
- Find Recall in the list
- Ensure Microsoft Word is checked/enabled
- Restart Recall after changing the setting
Certificate not trusted (macOS Advanced mode)¶
- Open Keychain Access
- Search for "Recall" or "localhost"
- Ensure the certificate shows a blue plus icon (trusted)
- If it shows a red X, double-click and update trust settings
Changing Integration Mode¶
You can switch between modes at any time:
- Open Settings from the gear icon popup menu
- Go to the Word Integration section
- Select your preferred mode
- Follow the setup steps for that mode