Install atbridge.ai
In short: add the atbridge.ai add-on to Thunderbird, and a setup wizard opens and does the rest. About five minutes — and on macOS and Windows you never have to open a terminal.
Step-by-step install guides are live — pick your OS and follow along:
What you need before you start
Section titled “What you need before you start”- Thunderbird 128 or newer. Check via Help → About Thunderbird. Download Thunderbird if you don’t have it yet.
- At least one mail account configured in Thunderbird, with “Keep messages for this account on this computer” enabled. Most people already have this on by default.
1. Add the add-on to Thunderbird
Section titled “1. Add the add-on to Thunderbird”Download the add-on from the download page, then in Thunderbird:
-
Open Settings (the ☰ menu → Settings).
-
Go to Add-ons and Themes.
-
Open the gear menu at the top right and choose Install Add-on From File…
-
Pick the
.xpifile you downloaded. -
Click Add when Thunderbird asks.
2. Follow the setup wizard
Section titled “2. Follow the setup wizard”As soon as the add-on loads, the atbridge.ai setup wizard opens by itself. It walks you through everything below — you can press Skip for now on any step you would rather do later.
Step 1 — Install the atbridge.ai core
Section titled “Step 1 — Install the atbridge.ai core”This is the only step that differs by operating system.
Click Install atbridge.ai core. It downloads and runs the signed installer for you; the wizard shows Waiting for atbridge.ai core… and moves on by itself when it lands.
If it doesn’t finish, click I’ve installed it — check now.
Prefer to run it yourself?
curl -fsSL https://atbridge.ai/install.sh | shClick Install atbridge.ai core. It runs the signed installer in the background — no terminal window opens, and no admin rights are needed; everything installs for your user only.
If it doesn’t finish, click I’ve installed it — check now.
Prefer to run it yourself?
irm https://atbridge.ai/install.ps1 | iexOn Linux there is no one-click button — the wizard shows the command already expanded under Install atbridge core. Paste it into a terminal:
curl -fsSL https://atbridge.ai/install.sh | shThen click I’ve installed it — check now.
Thunderbird from Snap or Flatpak? A confined Thunderbird can’t launch the helper directly, so the wizard shows a second section, Thunderbird from Snap or Flatpak? Run this once as well, then click Enable local bridge:
atbridge bridge service install && atbridge bridge service startStep 2 — Activate
Section titled “Step 2 — Activate”Enter your name and email and click Send code, then Start trial once the code arrives. Already bought a plan? Use Detect & activate, or open Have a license key? and paste it in.
Step 3 — How you’ll use it
Section titled “Step 3 — How you’ll use it”Pick Inside Thunderbird, From an external AI app (MCP), or both. Choose at least one to continue.
Step 4 — Connect your AI
Section titled “Step 4 — Connect your AI”Choose a provider, paste your API key, and click Connect. If you picked the MCP route in step 3, you get a list of apps to set up instead.
Step 5 — Preferences
Section titled “Step 5 — Preferences”Response language, your atbridge Notes folder, web search, and region. All optional.
Step 6 — Permissions
Section titled “Step 6 — Permissions”Review what atbridge.ai may do with your mailboxes, calendars and contacts. You can change any of it later in Settings.
Step 7 — Done
Section titled “Step 7 — Done”Click Close Wizard. The @b button appears in Thunderbird’s toolbar.
3. Check it worked
Section titled “3. Check it worked”Open the @b button in Thunderbird — the AI Chat pane should open and your plan should show as active.
Prefer to check from a terminal?
atbridge license status --prettyNext: connect your AI
Section titled “Next: connect your AI”You’re installed. Now hook up your AI assistant →
Stuck?
Section titled “Stuck?”If something broke at any of the steps above and the error message didn’t point at a clear fix, drop a note here. It goes straight to a human — we read every one.
Was this page helpful?
Thanks for the feedback!