Integrations
Translation, grammar checking and contact details, with your own servers or keys.
Integrations connect Airpost to outside services you choose: a translation service, a grammar checker, and a contact-details lookup. Nothing is sent to any of them until you set one up and turn it on. Configure them in Preferences > Integrations.
The requests are made by the engine, not by the window. The engine holds the keys, adds the right headers, enforces timeouts and caches the answers. The window only ever sees the result.
Overview
| Integration | Services | What is sent | Cached for |
|---|---|---|---|
| Translation | LibreTranslate, DeepL | The text you translate | 24 hours, up to 1,000 translations |
| Grammar | LanguageTool (public, self-hosted or premium) | Your draft text | Not cached |
| Contact details | People Data Labs | Email addresses of people you view | 7 days when found, 24 hours when not, up to 500 profiles |
Each request has a 10 second connect timeout and a 30 second overall timeout. When a service rate-limits and sends Retry-After, the engine waits that long before trying again.
Set one up
Open Preferences > Integrations
Each integration has a status: Off, On or Error. Click Set up on the one you want.
Pick a service and fill it in
Choose the Service and enter its server and key, as described below.
Test it
Click Test. On success you see “Connected to” and the host. The page also tells you exactly where your text will go, for example “Message text you translate is sent to libretranslate.com.”
Translation
Translate drafts in the composer and incoming messages.
| Service | What you enter |
|---|---|
| LibreTranslate | Server (for example https://libretranslate.com, or your own) and an optional API key |
| DeepL | API key (required) |
DeepL has two endpoints. Keys from the free DeepL API plan end in :fx and only work against https://api-free.deepl.com; Airpost sends those there and every other key to https://api.deepl.com. You don’t pick the endpoint yourself.
If you run LibreTranslate on your own machine or network, translated text never leaves it. A typical local setup:
docker run -p 5000:5000 libretranslate/libretranslate
Then enter http://localhost:5000 as the Server.
Translating incoming mail
On a message in another language, Airpost offers to translate it. You can translate once, or choose Always translate or Never translate for that language. Show Original switches back. Because translations are cached, switching back and forth doesn’t send the text again.
Grammar
Grammar checking uses LanguageTool.
| Option | Server | What you enter |
|---|---|---|
| Public server | https://api.languagetool.org | Nothing |
| Your own server | Its address, in Server | Nothing, usually |
| Premium | https://api.languagetoolplus.com | Premium account (your LanguageTool email) and Premium API key |
The premium account and key go together; entering only one of them is an error. Turn checking on with Check grammar in Preferences > Composing & sending. Your draft text is sent as you write, so if that matters, run your own LanguageTool server.
Contact details
People Data Labs adds job titles, companies and profiles to the people in your threads, shown in the participant profile panel. It needs an API key. The email addresses of people you view are sent to People Data Labs (https://api.peopledatalabs.com).
Lookups that find nothing are remembered for a day, so the same unknown address isn’t looked up every time you open the thread. Lookups that find someone are kept for a week.
Managing keys
Keys are stored by the engine with your account passwords, in the macOS Keychain or the Linux Secret Service. After you save one it isn’t shown again: the field reads “Saved. Type a new key to replace it.” Click Save key to replace it, or Forget key to remove it.
| Button | Effect |
|---|---|
| Test | Checks the connection with the current settings. |
| Turn off / Turn on | Stops or resumes using the integration, keeping its settings and key. |
| Remove saved keys | Deletes the stored keys for that integration. |
| Remove | Removes the integration’s setup. |
Also in Integrations
The tab links to AI (AI features) and MCP (Agents), which have their own Preferences tabs. AI providers and their keys are managed there, not here.