Airpost
Customize

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

IntegrationServicesWhat is sentCached for
TranslationLibreTranslate, DeepLThe text you translate24 hours, up to 1,000 translations
GrammarLanguageTool (public, self-hosted or premium)Your draft textNot cached
Contact detailsPeople Data LabsEmail addresses of people you view7 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.

ServiceWhat you enter
LibreTranslateServer (for example https://libretranslate.com, or your own) and an optional API key
DeepLAPI 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.

OptionServerWhat you enter
Public serverhttps://api.languagetool.orgNothing
Your own serverIts address, in ServerNothing, usually
Premiumhttps://api.languagetoolplus.comPremium 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.

ButtonEffect
TestChecks the connection with the current settings.
Turn off / Turn onStops or resumes using the integration, keeping its settings and key.
Remove saved keysDeletes the stored keys for that integration.
RemoveRemoves 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.

  • Privacy lists everything that can leave your computer.
  • Plugins: the Translation, Grammar check and Participant profile plugins are the parts of the app that use these integrations.