# Thunderbird MCP

> Thunderbird MCP is an open-source MCP server for communication. Open-source MCP server letting AI agents search, read, draft and send Thunderbird and IMAP. It runs locally on your machine and is started by your AI client.

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

## About

The README says this project is a Python MCP server paired with a tbmail command-line tool, so an agent in Claude Code, Codex or OpenCode can work with a mailbox directly. Search covers downloaded Thunderbird mbox and Maildir mail with keyword and local semantic ranking, plus live IMAP queries and native Gmail and Microsoft Graph adapters.

Sending is built around saved drafts. Each draft stores its exact MIME message and is claimed atomically at delivery, so repeated sends are blocked, and drafts can be handed to Thunderbird's Drafts folder without being sent. Tool profiles (read-only, draft-only, full) and allowlists restrict what an agent may do.

It suits developers and power users who already run Thunderbird or IMAP and want an agent to triage, cite or reply to mail from a terminal session. Mail credentials are kept in the system keyring, and the README notes that text returned to a hosted AI client goes to that client's model provider.

## Features

- **Local mail search:** Keyword and local semantic search over downloaded Thunderbird mail, with filters for sender, folder, dates and attachments.
- **Live IMAP queries:** Searches a server folder directly for fresh unread or matching mail without waiting for a local index refresh.
- **Attachment text extraction:** Reads text from PDF, Office and other attachment formats and makes it searchable.
- **Saved-draft sending:** Sends only exact stored drafts with duplicate-send protection, and can save drafts to Thunderbird without sending.
- **Stable mail references:** Returns citation URIs based on Message-ID that survive reindexing and folder changes.
- **Profile-based tool access:** Read-only, draft-only and full profiles plus tool allowlists limit what an agent can change.

## Good for

- Finding an invoice or agreement across months of mail and reading the matching attachment
- Preparing reply drafts for review before anything is sent
- Citing specific emails in another agent session using a stable reference
- Triaging unread live IMAP mail with previewed organize actions
- Exporting selected messages and PDFs into a project folder

## Install

### Claude Code (Terminal)

```sh
claude mcp add thunderbirdmcp -- uvx thunderbird-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "thunderbirdmcp": {
      "command": "uvx",
      "args": [
        "thunderbird-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "thunderbirdmcp": {
      "command": "uvx",
      "args": [
        "thunderbird-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "thunderbirdmcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "thunderbird-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "thunderbirdmcp": {
      "command": "uvx",
      "args": [
        "thunderbird-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "thunderbirdmcp": {
      "command": "uvx",
      "args": [
        "thunderbird-mcp"
      ]
    }
  }
}
```

## Tools

- `search_email`: Search local indexed mail.
- `search_live_email`: Search one server folder over live IMAP.
- `get_email`: Read a message.
- `get_thread`: Read a conversation thread.
- `get_email_reference`: Return a stable citation reference for a message.
- `get_attachment_text`: Extract text from a selected attachment.
- `draft_email`: Create an unsent draft.
- `draft_reply`: Create a reply draft.
- `send_draft`: Send a saved draft.
- `move_emails`: Move messages between folders.

## FAQ

### Which mail providers are supported?

The README describes IMAP and SMTP access, native Gmail API and Microsoft Graph adapters, and local Thunderbird mbox or Maildir storage.

### Is it free to use?

The README states the project is released under the MIT licence and runs locally from source or PyPI.

### Which AI clients does it work with?

The README names Claude Code, Codex, OpenCode (including GLM) and Terminalman, and setup can register it with Antigravity and Gemini CLI.

### Can the agent send email without approval?

Sending goes through saved drafts and requires an explicit confirm step in the tbmail workflow; direct send_email defaults to a preview.

### Is Thunderbird MCP free?

Yes. Thunderbird MCP is open source, so you can use and self-host it for free.

### How do I add Thunderbird MCP to Claude Code?

Run this command in your terminal: claude mcp add thunderbirdmcp -- uvx thunderbird-mcp

### What are the best alternatives to Thunderbird MCP?

The closest alternatives to Thunderbird MCP are Thunderbird Cli, Mac Mail MCP, WireCat Mail, Claws Mail MCP Plugin and mcp-mail.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Thunderbird Cli](https://ai-powered.com/mcp/thunderbird-cli): Thunderbird Cli is an open-source MCP server for communication.
- [Mac Mail MCP](https://ai-powered.com/mcp/mac-mail-mcp): Mac Mail 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.
- [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.
- [mcp-mail](https://ai-powered.com/mcp/mcp-mail): mcp-mail is an open-source MCP server for communication.
- [Outlook Mac MCP](https://ai-powered.com/mcp/outlook-mac-mcp): Outlook Mac MCP is an open-source MCP server for communication.
- [OpenMail](https://ai-powered.com/mcp/openmail): OpenMail is a freemium 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-mcp
