Provides tools for reading, organizing, and automating Thunderbird email accounts, including managing folders, messages, rules, scanning, search, and archiving.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@aiconnect archive my inbox emails older than 365 days and show me the plan first"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Let AI tools (Claude Code, Claude Desktop, Cowork, anything that speaks MCP) and your shell read, organize and automate your Thunderbird accounts. Three parts:
Thunderbird extension (extension/): executes commands inside Thunderbird. Dials a local WebSocket,
never listens, never talks to the internet.
aiconnect CLI (src/): hosts that WebSocket on 127.0.0.1:47800, exposes commands, and can run as
an MCP server (aiconnect mcp).
Skill (skill/aiconnect/SKILL.md): tells an AI assistant how to use it safely.
Everything runs on your machine. The only credential is a random pairing token so no other local process can drive your mailbox.
Not on npm yet — install from this repo.
git clone https://github.com/guuslangelaar0/aiconnect.git
cd aiconnect
npm install
npm link # optional: puts `aiconnect` on your PATHWithout npm link, run any command as node dist/aiconnect.mjs <cmd> (a prebuilt single-file
bundle) or node src/cli.js <cmd>.
aiconnect pair # prints port + token; stored in ~/.aiconnect/config.json
aiconnect build-xpi # writes dist/aiconnect-<version>.xpiInstall the extension in Thunderbird: Add-ons and Themes → gear icon → Install Add-on From File…
→ pick dist/aiconnect-<version>.xpi (or download it from the repo's Releases). Click the AIConnect
toolbar button (or Add-ons → AIConnect → Preferences), enter the token, Save.
aiconnect status # "connected: AIConnect extension 0.2.2 in Thunderbird 155.0.1"For development, load extension/ via Add-ons → gear → Debug Add-ons → Load Temporary Add-on.
Publishing to npm (so
npm i -g aiconnectworks) is planned but not done yet.
Related MCP server: thunderbird-cli
aiconnect accounts --counts # accounts and folder trees
aiconnect scan -o scan.json # inventory + inbox sender/domain/year analysis
aiconnect suggest scan.json --rules-out rules.json --lang nl
aiconnect rules dry-run rules.json # counts only
aiconnect rules apply rules.json --yes # move existing mail
aiconnect rules save rules.json # extension sorts new mail from now on
aiconnect archive me@example.com --to "Inbox/Archive" --by-year --older-than 365 # dry run
aiconnect archive me@example.com --to "Inbox/Archive" --by-year --older-than 365 --yes
aiconnect messages search --from bunq --since 2026-01-01
aiconnect messages read 12345
aiconnect messages move 12345 12346 --to "me@example.com:Inbox/Receipts"Every command accepts --json. Folder references are account:Path/By/Names; some IMAP servers nest
all folders under Inbox/, use the paths aiconnect folders list shows.
{ "mcpServers": { "aiconnect": { "command": "aiconnect", "args": ["mcp"] } } }Tools: status, list_accounts, list_folders, create_folder, scan, suggest, list_messages,
search_messages, read_message, move_messages, update_messages, delete_messages, rules_dry_run,
rules_apply, rules_save, rules_get, archive. Destructive tools require confirm: true.
[{ "account": "me@example.com", "field": "from", "patterns": ["medium.com"], "dest": "Inbox/News/Medium" }]field is from, subject, any or to; patterns are case-insensitive substrings; first match wins;
dest is created if missing. Saved rules are applied by the extension to new mail in that account's inbox.
suggest thinksInbox should hold only what needs a human. Automated mail is classified by sender address, display name
and sample subjects into: receipts, orders, newsletters, notifications, social, dev, jobs, government,
finance, housing, family. Senders above --vendor-threshold messages per year get their own sub-folder.
Existing folders are reused when their name is a known synonym (Boekhouding → receipts,
Nieuwsbrieven → newsletters, …). Old mail is archived per year (Gmail: into All Mail). Nothing is ever
deleted by a suggestion. Use --probe on scan to check List-Unsubscribe headers for better
newsletter detection and an unsubscribe list.
JSON over WebSocket. Extension → bridge: {"type":"hello","token":…}. Bridge → extension:
{"id":1,"method":"messages.move","params":{…}}; reply {"id":1,"result":…} or {"id":1,"error":{"message":…}};
progress {"method":"progress","params":{"id":1,"done":100,"total":500,"label":"moving"}}.
Methods: ping, accounts.list, folders.list|info|ensure|rename|delete, messages.list|query|get|read|move|copy|delete|archive|update,
tags.list, scan.folder, rules.get|set|run, archive.run. See extension/rpc.js.
Thunderbird 128+ (tested on 155), Node 18+.
MIT
Built by Guus Langelaar (Devidee B.V.) with Claude Code.
🤖 Generated with Claude Code
This server cannot be deployed
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Your agent needs a mailbox of its own — to receive, thread, draft and send, with attachments, without borrowing your personal inbox or your company's SMTP. **What you can ask for** • "Create an inbox for this agent and tell me its address." • "Read the new messages in this thread and draft a reply." • "Send this message with the attachment and wait for the response." • "Search this inbox for everything from that domain." • "Show delivery metrics and the events on this inbox." **How to use it** Point any MCP client at https://mcp.aisa.one/mail/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: create and delete inboxes, list and read messages, raw message bodies, attachments, threads, drafts and draft attachments, send and reply, message search, inbox events, metrics, and list entries — reads and writes. **Why this rather than the source** A real inbox an agent owns, rather than an SMTP credential it borrows from a human. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the contact elsewhere in the catalogue, then write to them from here — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/sales/mcp finds the person to write to.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
