Skip to content
MCP server

Thunderbird Cli

Local MCP server that lets AI agents read and draft email through Thunderbird

Runs locally
Install
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-mcp

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

How AIPoweredBot checks servers