Thunderbird Cli
Local MCP server that lets AI agents read and draft email through Thunderbird
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 1.2.0
- Listing updated
- 4 days ago
Similar MCP servers
About Thunderbird Cli
Thunderbird Cli is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
Instead of connecting to IMAP directly, this server talks to a small bridge daemon and a Thunderbird extension running on your own machine. Thunderbird keeps the mail credentials and sync state, so the agent never sees a password.
The README describes a tb command line with 38 commands for reading, searching, composing, replying, bulk moves, folder management and attachment downloads. The MCP server exposes a curated set of 12 of these tools to clients such as Claude Desktop, and a companion Claude Skill teaches the agent token-efficient field selection and safe defaults.
Safety defaults matter here: composing, replying and forwarding save drafts rather than sending, and permanent deletion needs an explicit confirm flag. The README says the bridge is localhost-only with no telemetry, and it reports testing against 22 accounts and more than 249,000 messages.
Install
Run in a terminal
claude mcp add thunderbird-cli --env TB_AUTH_TOKEN='<TB_AUTH_TOKEN>' -- npx -y thunderbird-cli-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"thunderbird-cli": {
"command": "npx",
"args": [
"-y",
"thunderbird-cli-mcp"
],
"env": {
"TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"thunderbird-cli": {
"command": "npx",
"args": [
"-y",
"thunderbird-cli-mcp"
],
"env": {
"TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"thunderbird-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"thunderbird-cli-mcp"
],
"env": {
"TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"thunderbird-cli": {
"command": "npx",
"args": [
"-y",
"thunderbird-cli-mcp"
],
"env": {
"TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"thunderbird-cli": {
"command": "npx",
"args": [
"-y",
"thunderbird-cli-mcp"
],
"env": {
"TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
TB_BRIDGE_HOSTHostname of the thunderbird-cli-bridge (default: 127.0.0.1). Set to host.docker.internal when running inside a container.TB_BRIDGE_PORTHTTP port of the thunderbird-cli-bridge (default: 7700).TB_AUTH_TOKENBearer token, required only if the bridge was started with TB_AUTH_TOKEN.
What it does
- No credentials exposed
- IMAP and SMTP stay inside Thunderbird, so the agent works without handling passwords or OAuth.
- Draft-by-default writing
- Compose, reply and forward save drafts, and permanent delete requires confirmation.
- Token-saving output
- Field selection, compact mode and body truncation keep responses small for the model.
- Bridge and extension
- A Thunderbird WebExtension and a local HTTP-to-WebSocket bridge connect the MCP server to the mail client.
- Multi-account search
- Search and bulk operations work across every account configured in Thunderbird.
Good for
- Ask an assistant how many unread messages sit across all accounts
- Find invoices from a given sender in the last 30 days
- Draft a reply to a message for later review
- Download an attachment from a specific message
- Bulk-archive old newsletters into another folder
Pricing
Open source
MIT licence; free to install from npm
Thunderbird Cli FAQ
Does it need my email password?
No. The README says all IMAP and SMTP handling stays in Thunderbird, and the server only talks to a local bridge.
Will the agent send mail on its own?
By default compose, reply and forward save drafts. Permanent delete needs a confirm flag.
Which Thunderbird versions work?
The README lists Thunderbird 128 or later.
How do I add it to Claude Desktop?
Add an mcpServers entry that runs npx -y thunderbird-cli-mcp, then restart the app; the bridge and extension must also be running.
Is Thunderbird Cli free?
Yes. Thunderbird Cli is open source, so you can use and self-host it for free.
How do I add Thunderbird Cli to Claude Code?
Run this command in your terminal: claude mcp add thunderbird-cli --env TB_AUTH_TOKEN='<TB_AUTH_TOKEN>' -- npx -y thunderbird-cli-mcp
What are the best alternatives to Thunderbird Cli?
The closest alternatives to Thunderbird Cli are Thunderbird MCP, Lettio MCP, WireCat Mail, mcp-mail and Claws Mail MCP Plugin.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.