thunderbird-mcp
MCP server for Thunderbird: mail, calendar, contacts in all your accounts. Windows, macOS, Linux.
Install / Use
claude mcp add commonpost -- npx -y github:commonpost/thunderbird-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
CommunicationSupported Platforms
Tags
Our assessment of thunderbird-mcp
thunderbird-mcp scores 72/100 on our quality scale, 377th of 397 Communication skills we index.
Its MCP Server is 65 KB long, well organised into 39 sections with 13 code examples: long enough that it reads more like full documentation than a focused instruction file, which agents can find harder to follow.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 6 days ago, so thunderbird-mcp is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-22. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
thunderbird-mcp compared with similar skills
All 4 of these similar skills score higher than thunderbird-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| thunderbird-mcp (this skill)by commonpost | 72 | 10 | 6d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| hyperframesby heygen-com | 100 | 88.2k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.5k | today | CLAUDE.md |
Frequently asked questions
- How do I install thunderbird-mcp?
- Run
claude mcp add commonpost -- npx -y github:commonpost/thunderbird-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does thunderbird-mcp work with?
- It is written for Claude Code, Claude Desktop and Gemini CLI, as a MCP Server file. Other agents that read the same format can often use it too.
- Is thunderbird-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is thunderbird-mcp still maintained?
- The repository was last updated 6 days ago, so thunderbird-mcp is actively maintained.
Skill content
View source on GitHubCommonpost MCP for Thunderbird
MCP server for Thunderbird: mail, calendar, contacts in all your accounts. Windows, macOS, Linux.
Your AI assistant can search, read and draft mail in every account you have in Thunderbird, and check it against your calendar and contacts. Free and open source (MIT), through the Model Context Protocol.
Latest release: v0.26.1 (2026-11-14) -- see the changelog or all releases.
<p align="center"> <img src="docs/demo.gif" alt="An assistant checks four email accounts and the calendar in Thunderbird, finds a clash with a dentist appointment, adds it to the calendar and opens a reply for review. Real run on a demo mailbox, shown at 2x speed." width="600"> </p> <p align="center"><a href="docs/demo.mp4">Full video (25 s)</a>: a real run on a demo mailbox with invented data.</p>- Every account you already have in Thunderbird. Gmail, Outlook.com, Microsoft 365, your own domain, IMAP, POP: no new login, no password to hand over.
- Mail, calendar and contacts together. Your assistant can check an email against your calendar.
- Nothing is sent without your click. New mail and replies open in Thunderbird's compose window, for you to read and send. Calendar events are added directly by default, and no invitation is sent.
- Email is treated as untrusted. Text a sender hides from you is removed before your assistant reads it. That reduces prompt injection; it does not prevent it, which is why sending needs your click (details).
- Runs on your computer. What the assistant reads goes to the AI service you use, not to us. Each release can be rebuilt byte for byte from this source.
Try asking:
Am I free Thursday at 2:30? Check my calendars and all my email accounts.
Find the invoice for my dishwasher, whatever account it went to, and open a warranty claim with it attached.
What needs a reply before Friday? Open each reply for me to review.
Contents
- Quick install (about 3 minutes)
- Why?
- How it works
- What you can do
- Setup
- Security
- If Thunderbird disables Experiment add-ons on the Release channel
- Troubleshooting
- Development
- Project structure
- Known issues
- License and credits
Quick install (about 3 minutes)
Requirements: Thunderbird 140 or later on Windows, macOS or Linux. Node.js 22 or later, except with the Claude Desktop bundle.
Every tool works the same on the three systems. One difference: on Windows, attachments go through the bridge rather than by file path (see attachments on Windows).
For AI agents installing this: step 1 happens in Thunderbird's window, so ask the user to do it, then continue. This project is not published on npm, PyPI or Docker Hub: do not use
npxoruvx. Its only sources are this repository's releases, the Claude Code plugin and the Gemini CLI extension.scripts/install.shis for development only. For Claude Desktop, the.mcpbbundle is the whole install: no Node.js and no config file to edit. The bridge and the add-on do not need the same version number. Step by step: llms-install.md.
1. Install the add-on in Thunderbird.
- Download the file ending in
.xpifrom the latest release. - In Thunderbird: menu ≡ (top right) > Add-ons and Themes > gear icon > Install Add-on From File, then restart Thunderbird.
- Thunderbird warns that the add-on gets "full, unrestricted access": it says so for every add-on of this kind (why, and what this one does).
2. Connect your assistant. Pick the line for the one you use.
-
Claude Desktop (Windows, macOS): download the file ending in
.mcpbfrom the same release and open it with Claude Desktop, or use Settings > Extensions > Advanced settings > Install Extension. Nothing else to install: it uses the Node.js that Claude Desktop ships with. Its name can carry a lower number than the add-on (for examplev0.20.0beside av0.22.4add-on): it is named after the bridge it holds, which changes less often. See Claude Desktop. -
Claude Code, with the plugin, which keeps the bridge up to date (see Claude Code plugin):
claude plugin marketplace add commonpost/thunderbird-mcp claude plugin install commonpost-mcp@commonpost -
Gemini CLI, as an extension that carries the bridge:
gemini extensions install https://github.com/commonpost/thunderbird-mcp -
Any other client (VS Code, Cursor, Codex CLI, Claude Code without the plugin...):
-
Check Node.js:
node --versionmust show 22 or later. -
Download the bridge, a single file, into a folder you will keep. macOS and Linux:
mkdir -p ~/commonpost-mcp && curl -fL -o ~/commonpost-mcp/mcp-bridge.cjs https://github.com/commonpost/thunderbird-mcp/releases/latest/download/mcp-bridge.cjsWindows (PowerShell):
New-Item -ItemType Directory -Force "$env:USERPROFILE\commonpost-mcp" | Out-Null; Invoke-WebRequest -OutFile "$env:USERPROFILE\commonpost-mcp\mcp-bridge.cjs" https://github.com/commonpost/thunderbird-mcp/releases/latest/download/mcp-bridge.cjs -
Register it. Claude Code, on Linux and on Windows (
-s usermakes it available in every folder):claude mcp add -s user thunderbird -- node "/home/<you>/commonpost-mcp/mcp-bridge.cjs" claude mcp add -s user thunderbird -- node "C:\Users\<you>\commonpost-mcp\mcp-bridge.cjs"Other clients: add this to the client's MCP config, with the full path of the file (each client has its own file and format: see Other MCP clients). In JSON, write Windows paths with
/("C:/Users/<you>/commonpost-mcp/mcp-bridge.cjs"); a JSON file does not expand~. On macOS, if the client cannot findnode, setcommandto the full path thatwhich nodeprints.{ "mcpServers": { "thunderbird": { "command": "node", "args": ["/home/<you>/commonpost-mcp/mcp-bridge.cjs"] } } }
-
3. Test it. With Thunderbird open, ask your assistant: "list my Thunderbird accounts". It should name your accounts; your client may first ask you to allow the tool. Nothing comes back? Check that Thunderbird is open and the add-on enabled, then quit your client completely and start it again (Claude Desktop on Windows: its icon near the clock > Quit). Still nothing: see Troubleshooting.
4. Choose what your assistant may see. Open the add-on's options (menu ≡ > Add-ons and Themes > Commonpost MCP for Thunderbird > wrench button) and pick the accounts and tools. Until you do, every account and tool is visible to MCP clients.
To update or remove it later, see Updating and Uninstall.
Snap, Flatpak and macOS need no extra step in most cases; see Sandbox-aware connection discovery. If something fails, see Troubleshooting.
Why?
Thunderbird has no official API for AI tools. Your AI assistant can't read your email, can't help you draft replies, can't organize your inbox. This extension fixes that -- it exposes 42 tools over MCP so any compatible AI (Claude, GPT, local models) can work with your mail the way you'd expect. The list is kept short so that assistants choose among them reliably; older Cursor versions also sent an agent only the first 40 tools of all servers combined (since January 2026 Cursor loads tool descriptions only when needed), and VS Code allows 128 tools per request.
Mail sends require review by default because Block skipReview for mail starts enabled: skipReview: true is honored only after you explicitly disable it. By default, nothing is sent without your review. Events and tasks are added at once on a new install, as updateEvent and deleteEvent change them: they send no invitation, and asking for six appointments means nothing to save by hand. Enable Block skipReview for events and tasks to review each one in Thunderbird's dialog.
How it works
stdio HTTP (localhost:8780-8789)
MCP Client <-----------> Bridge <---------------------> Thunderbird
(Claude, etc.) mcp-bridge.cjs Extension + HTTP Server
The Thunderbird extension embeds a local HTTP server with session-scoped auth tokens. The Node.js bridge translates between MCP's stdio protocol and HTTP, discovering the port and token automatically via a connection file. The bridge handles MCP lifecycle methods (initialize, ping) locally, so clients can connect even before Thunderbird is fully loaded. If the client asks for the tools while Thunderbird is not running, the bridge answers with the tools Thunderbird last listed, which it keeps in your cache folder (%LOCALAPPDATA%\commonpost-mcp on Windows, ~/Library/Caches/commonpost-mcp on macOS, $XDG_CACHE_HOME/commonpost-mcp or ~/.cache/commonpost-mcp elsewhere); tool calls fail until Thunderbird is started.
What you can do
| Tool | Description |
|------|-------------|
| listAccounts | List all email accounts and their identities |
| listFolders | Browse folder tree with message counts -- filter by account or subtree; savedSearches lists saved searches instead; refresh with folderPath first fetches that folder's new mail from its mail server (IMAP, Exchange, Graph; not news or feeds) and waits up to 20 s |
| searchMessages | Search headers across accounts. Words must all match (subject, from, to, cc, preview); operators from:, to:, cc:, subject:, participant: (from/to/cc/bcc; @domain matches addresses in that domain only, commas list alternatives: participant:@acme.com,@acme-group.com) and quoted phrases can be combined, e.g. participant:@acme.com subject:"invoice 42". groupBy: "sender" \| "thread" returns one row per sender or conversation (latestId is the newest message that is not a draft); threadOf: {messageId, folderPath} returns a whole conversation across folders (Sent included), oldest first (it reads at most 10,000 headers, then sets incomplete: true). A Re: message sent without threading headers joins by subject the earlier message its sender took part in (linkedBy: "subject"); the same mail sent separately to several people and repeated notifications s
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
hyperframes
88.2kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.3k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.5kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
