# Thunderbird Cli

> Thunderbird Cli is an open-source MCP server for communication. Local MCP server that lets AI agents read and draft email through Thunderbird. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Repository:** https://github.com/vitalio-sh/thunderbird-cli
- **MCP Registry name:** io.github.vitalio-sh/thunderbird-cli
- **Categories:** [communication](https://ai-powered.com/categories/communication), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add thunderbird-cli --env TB_AUTH_TOKEN='<TB_AUTH_TOKEN>' -- npx -y thunderbird-cli-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "thunderbird-cli": {
      "command": "npx",
      "args": [
        "-y",
        "thunderbird-cli-mcp"
      ],
      "env": {
        "TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "thunderbird-cli": {
      "command": "npx",
      "args": [
        "-y",
        "thunderbird-cli-mcp"
      ],
      "env": {
        "TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "thunderbird-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "thunderbird-cli-mcp"
      ],
      "env": {
        "TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "thunderbird-cli": {
      "command": "npx",
      "args": [
        "-y",
        "thunderbird-cli-mcp"
      ],
      "env": {
        "TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "thunderbird-cli": {
      "command": "npx",
      "args": [
        "-y",
        "thunderbird-cli-mcp"
      ],
      "env": {
        "TB_AUTH_TOKEN": "<TB_AUTH_TOKEN>"
      }
    }
  }
}
```

## 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.

## Alternatives

- [Thunderbird MCP](https://ai-powered.com/mcp/thunderbird-mcp): Thunderbird MCP is an open-source MCP server for communication.
- [Lettio MCP](https://ai-powered.com/mcp/lettio-mcp): Lettio MCP is an open-source MCP server for communication.
- [WireCat Mail](https://ai-powered.com/mcp/wirecat-mail): WireCat Mail is an open-source MCP server for communication.
- [mcp-mail](https://ai-powered.com/mcp/mcp-mail): mcp-mail is an open-source MCP server for communication.
- [Claws Mail MCP Plugin](https://ai-powered.com/mcp/claws-mail-mcp-plugin): Claws Mail MCP Plugin is an open-source MCP server for communication.
- [Imap Wizard](https://ai-powered.com/mcp/imap-wizard): Imap Wizard is an open-source MCP server for productivity.
- [Gmail Tidy MCP](https://ai-powered.com/mcp/gmail-tidy-mcp): Gmail Tidy MCP is an open-source MCP server for communication.
- [Proton Mail](https://ai-powered.com/mcp/proton-mail): Proton Mail is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/thunderbird-cli
