{"_id":"thunderbird-cli-mcp","_rev":"6-7475a6c26b7f5bdbe6cd28fce93411c7","name":"thunderbird-cli-mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"thunderbird-cli-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","thunderbird","email","claude","claude-desktop","ai-agents"],"author":{"name":"Vitalio Ionov"},"license":"MIT","_id":"thunderbird-cli-mcp@1.0.0","maintainers":[{"name":"vitalio-sh","email":"psnukcool@gmail.com"}],"homepage":"https://github.com/vitalio-sh/thunderbird-cli/tree/main/mcp#readme","bugs":{"url":"https://github.com/vitalio-sh/thunderbird-cli/issues"},"bin":{"tb-mcp":"src/server.js"},"dist":{"shasum":"11dc6cc65e9ecc5867e2de5a4ea60089b841e939","tarball":"https://registry.npmjs.org/thunderbird-cli-mcp/-/thunderbird-cli-mcp-1.0.0.tgz","fileCount":5,"integrity":"sha512-CKCWWEUHfBNrdtE1on8bIagjYJJ1xNldE5agHXlmK/xnKSjtg6f8pHDIwrIX4m4AwV1lohEjGgOvdl0CpMnu9w==","signatures":[{"sig":"MEUCIHkxu/mBvMyI42YAfFmY9hom2pDT63AHzhVAl3Q0FptAAiEAmDHJRD3hD44XGU2PdR8J0GSqLfSDMm/h70Lxr/e62qU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33758},"type":"module","engines":{"node":">=18"},"gitHead":"45bbafbcaada9c2ad29722064b55d6cf79c9a704","scripts":{"start":"node src/server.js","prepublishOnly":"cd .. && npm run test:mcp"},"_npmUser":{"name":"vitalio-sh","email":"psnukcool@gmail.com"},"repository":{"url":"git+https://github.com/vitalio-sh/thunderbird-cli.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"MCP server that gives Claude Desktop full access to your email through Mozilla Thunderbird. 12 high-level tools: search, read, compose, reply, attachments, folders.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/thunderbird-cli-mcp_1.0.0_1775686365992_0.5146538753421313","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"thunderbird-cli-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","thunderbird","email","claude","claude-desktop","ai-agents"],"author":{"name":"Vitalio Ionov"},"license":"MIT","_id":"thunderbird-cli-mcp@1.0.1","maintainers":[{"name":"vitalio-sh","email":"psnukcool@gmail.com"}],"homepage":"https://github.com/vitalio-sh/thunderbird-cli/tree/main/mcp#readme","bugs":{"url":"https://github.com/vitalio-sh/thunderbird-cli/issues"},"bin":{"tb-mcp":"src/server.js"},"dist":{"shasum":"c911de61f57f7eecd175594f9e3b497dd701f804","tarball":"https://registry.npmjs.org/thunderbird-cli-mcp/-/thunderbird-cli-mcp-1.0.1.tgz","fileCount":5,"integrity":"sha512-UVumWUuZkkD9Hxfv702BkBOWBFM19O7LlB3Bp+f+j/2eis8TCJ1nbtGBhKgNLJplbK1ngHGDIsGgnuwBYIVRJQ==","signatures":[{"sig":"MEUCIEI6Y71eadnllSU95SCll59yv7fS6rzD6qPSEJey9OmzAiEA0ASyDnzRASxALQe+nTjEEPbXG8NMmiYJGJD117wJEDk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33895},"type":"module","engines":{"node":">=18"},"gitHead":"c6973e8c689985b3b27f14de5734713a1edf8659","scripts":{"start":"node src/server.js","prepublishOnly":"cd .. && npm run test:mcp"},"_npmUser":{"name":"vitalio-sh","email":"psnukcool@gmail.com"},"repository":{"url":"git+https://github.com/vitalio-sh/thunderbird-cli.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"MCP server that gives Claude Desktop full access to your email through Mozilla Thunderbird. 12 high-level tools: search, read, compose, reply, attachments, folders.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/thunderbird-cli-mcp_1.0.1_1775687973375_0.5327646014770169","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"thunderbird-cli-mcp","version":"1.0.2","keywords":["mcp","mcp-server","model-context-protocol","claude","claude-desktop","anthropic","thunderbird","email","email-client","imap","smtp","cli","ai-agent","ai-tools","agentic","automation","localhost","privacy"],"author":{"name":"Vitalii Ionov"},"license":"MIT","_id":"thunderbird-cli-mcp@1.0.2","maintainers":[{"name":"vitalio-sh","email":"psnukcool@gmail.com"}],"homepage":"https://github.com/vitalio-sh/thunderbird-cli/tree/main/mcp#readme","bugs":{"url":"https://github.com/vitalio-sh/thunderbird-cli/issues"},"bin":{"tb-mcp":"src/server.js"},"dist":{"shasum":"18c15b4e3641b76dee69f911582454843698d1f9","tarball":"https://registry.npmjs.org/thunderbird-cli-mcp/-/thunderbird-cli-mcp-1.0.2.tgz","fileCount":5,"integrity":"sha512-yRWJ0js2tgHZq9EpJVCnBICJVT+XMNjETHteZH/fsgqx1ZUW+YF4ziUcdlmhem+wA85LvGUaX4FnEKZyr7rqNA==","signatures":[{"sig":"MEUCIQCZh8zN+f/NB9UGX7oSdytohULZWSwEIQ7BpEzY80TPJQIgFKWoieu24qUAyAlzlhAYdtBJAPH4AEscJug0Ut6jpTs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34118},"type":"module","engines":{"node":">=18"},"gitHead":"670e995e09a1c09b4dd1fdb3f1cce04ad7e8c3d1","mcpName":"io.github.vitalio-sh/thunderbird-cli","scripts":{"start":"node src/server.js","prepublishOnly":"cd .. && npm run test:mcp"},"_npmUser":{"name":"vitalio-sh","email":"psnukcool@gmail.com"},"repository":{"url":"git+https://github.com/vitalio-sh/thunderbird-cli.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"MCP server that gives Claude Desktop full access to your email through Mozilla Thunderbird. 12 high-level tools: search, read, compose, reply, attachments, folders.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/thunderbird-cli-mcp_1.0.2_1776533622424_0.8557560634484631","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"thunderbird-cli-mcp","version":"1.1.0","keywords":["mcp","mcp-server","model-context-protocol","claude","claude-desktop","anthropic","thunderbird","email","email-client","imap","smtp","cli","ai-agent","ai-tools","agentic","automation","localhost","privacy"],"author":{"name":"Vitalii Ionov"},"license":"MIT","_id":"thunderbird-cli-mcp@1.1.0","maintainers":[{"name":"vitalio-sh","email":"psnukcool@gmail.com"}],"homepage":"https://github.com/vitalio-sh/thunderbird-cli/tree/main/mcp#readme","bugs":{"url":"https://github.com/vitalio-sh/thunderbird-cli/issues"},"bin":{"tb-mcp":"src/server.js"},"dist":{"shasum":"5e3f1ede654028519fb4718bdec27222ee165680","tarball":"https://registry.npmjs.org/thunderbird-cli-mcp/-/thunderbird-cli-mcp-1.1.0.tgz","fileCount":5,"integrity":"sha512-aUx9H+SSt/2eyUftZy/rVNYUU1XZQsRAT0H4DVHWLM7mzUZey4LUuC7oHlNX/1D3camOkGeVzynS8PgA3OH8MA==","signatures":[{"sig":"MEUCIHuKNl27AlHZWEcYuCjyCjozYP6x3PNLohYsxUC6jtK9AiEAqQK4NSeSeGeJzzrwgidvVOcERvVoBwnTCYpD9V4v7m8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDIRS3AebekI+MTHfdwk7ruA26dLPiy11u8zVQCLzwb0gIgLOWaNptAIOwXm//30fvqwvTiMeKkYejglvYlaGXYdHI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35747},"type":"module","engines":{"node":">=18"},"gitHead":"f39122fd423c96cd39f141f3fda70eeff93fbd63","mcpName":"io.github.vitalio-sh/thunderbird-cli","scripts":{"start":"node src/server.js","prepublishOnly":"cd .. && npm run test:mcp"},"_npmUser":{"name":"vitalio-sh","email":"psnukcool@gmail.com"},"repository":{"url":"git+https://github.com/vitalio-sh/thunderbird-cli.git","type":"git","directory":"mcp"},"_npmVersion":"11.6.0","description":"MCP server that gives Claude Desktop full access to your email through Mozilla Thunderbird. 12 high-level tools: search, read, compose, reply, attachments, folders.","directories":{},"_nodeVersion":"24.8.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/thunderbird-cli-mcp_1.1.0_1789399540557_0.2530368882394738","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"thunderbird-cli-mcp","version":"1.1.1","keywords":["mcp","mcp-server","model-context-protocol","claude","claude-desktop","anthropic","thunderbird","email","email-client","imap","smtp","cli","ai-agent","ai-tools","agentic","automation","localhost","privacy"],"author":{"name":"Vitalii Ionov"},"license":"MIT","_id":"thunderbird-cli-mcp@1.1.1","maintainers":[{"name":"vitalio-sh","email":"psnukcool@gmail.com"}],"homepage":"https://github.com/vitalio-sh/thunderbird-cli/tree/main/mcp#readme","bugs":{"url":"https://github.com/vitalio-sh/thunderbird-cli/issues"},"bin":{"tb-mcp":"src/server.js"},"dist":{"shasum":"5c8ca148892a37a9e271a776362bd036c3283f7d","tarball":"https://registry.npmjs.org/thunderbird-cli-mcp/-/thunderbird-cli-mcp-1.1.1.tgz","fileCount":5,"integrity":"sha512-GEgrMGYC8G+ok5RPSP5sl1ZVejkQYcK7uzGxU9dSx3MbZkDAVJx+3xFx5YQgNIRKO3kRbW+MzAOGr8pmZdPLPQ==","signatures":[{"sig":"MEUCIFhVURzOj3nPuC+7PMta5jddZVycSmqiwtFJiJ0G82H3AiEA+IVmZEWHGkNWRoNuflVr/2PAEtry7qJ0orH9UNJD1gk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIE9r+1MRqPYBkqRP4X6+y8mu/5DbIU5K/b+lFcDv2z5BAiEA5cYQ5G7Pk/e15dPs0jAsl4IGAxXrVaVGcsWWlpqX+y8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41780},"type":"module","engines":{"node":">=18"},"gitHead":"04e5c19006f2137ad4f7eab3ddd60be7afc17714","mcpName":"io.github.vitalio-sh/thunderbird-cli","scripts":{"start":"node src/server.js","prepublishOnly":"cd .. && npm run test:mcp"},"_npmUser":{"name":"vitalio-sh","email":"psnukcool@gmail.com"},"repository":{"url":"git+https://github.com/vitalio-sh/thunderbird-cli.git","type":"git","directory":"mcp"},"_npmVersion":"11.19.0","description":"MCP server that gives Claude Desktop full access to your email through Mozilla Thunderbird. 12 high-level tools: search, read, compose, reply, attachments, folders.","directories":{},"_nodeVersion":"24.21.0","dependencies":{"@modelcontextprotocol/sdk":"^1.32.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/thunderbird-cli-mcp_1.1.1_1794504643683_0.7747760578040834","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"_id":"thunderbird-cli-mcp@1.2.0","bin":{"tb-mcp":"src/server.js"},"bugs":{"url":"https://github.com/vitalio-sh/thunderbird-cli/issues"},"dist":{"shasum":"181f96cb19cdab9e45f97a18f34148c75ee9528b","tarball":"https://registry.npmjs.org/thunderbird-cli-mcp/-/thunderbird-cli-mcp-1.2.0.tgz","fileCount":6,"integrity":"sha512-XQhiKpHbc8ZfGheOilXbAFv0cCnfJsYBH7GY1RYY6NQVP9xmzMX8lfa3GN+tYO6bYpDq4guZjzcLMONs3OcHQQ==","signatures":[{"sig":"MEYCIQCzvXUJof3UDUkn9/nRzCsPzWcA5icPLxMmwgBF3fTW+wIhAJdZTE9nPLlCUFFEMZhDEu3EiJaZxB8EE+82wO8Sdk40","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCT05raEXu4mGMl4WRZvL06jzfFG/LDqnWox+SEO/bHZAIgMS6XrS1mdGq21wb1RuTtUd6SiSPATnPaKqOHPqNNevQ="}],"unpackedSize":49551},"name":"thunderbird-cli-mcp","type":"module","author":{"name":"Vitalii Ionov"},"engines":{"node":">=18"},"gitHead":"4224eb0f5809a35dfcef032b7b21c6b1c4f06371","license":"MIT","mcpName":"io.github.vitalio-sh/thunderbird-cli","scripts":{"start":"node src/server.js","prepublishOnly":"cd .. && npm run test:mcp"},"version":"1.2.0","_npmUser":{"name":"vitalio-sh","email":"psnukcool@gmail.com"},"homepage":"https://github.com/vitalio-sh/thunderbird-cli/tree/main/mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","claude","claude-desktop","anthropic","thunderbird","email","email-client","imap","smtp","cli","ai-agent","ai-tools","agentic","automation","localhost","privacy"],"repository":{"url":"git+https://github.com/vitalio-sh/thunderbird-cli.git","type":"git","directory":"mcp"},"_npmVersion":"11.19.0","description":"MCP server that gives Claude Desktop full access to your email through Mozilla Thunderbird. 12 high-level tools: search, read, compose, reply, attachments, folders.","directories":{},"maintainers":[{"name":"vitalio-sh","email":"psnukcool@gmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"@modelcontextprotocol/sdk":"^1.32.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/thunderbird-cli-mcp_1.2.0_1794508236845_0.2971746630540908"}}},"time":{"created":"2026-04-08T22:12:45.880Z","modified":"2026-11-12T18:30:37.237Z","1.0.0":"2026-04-08T22:12:46.168Z","1.0.1":"2026-04-08T22:39:33.528Z","1.0.2":"2026-04-18T17:33:42.588Z","1.1.0":"2026-09-14T15:25:40.625Z","1.1.1":"2026-11-12T17:30:43.783Z","1.2.0":"2026-11-12T18:30:36.961Z"},"bugs":{"url":"https://github.com/vitalio-sh/thunderbird-cli/issues"},"author":{"name":"Vitalii Ionov"},"license":"MIT","homepage":"https://github.com/vitalio-sh/thunderbird-cli/tree/main/mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","claude","claude-desktop","anthropic","thunderbird","email","email-client","imap","smtp","cli","ai-agent","ai-tools","agentic","automation","localhost","privacy"],"repository":{"url":"git+https://github.com/vitalio-sh/thunderbird-cli.git","type":"git","directory":"mcp"},"description":"MCP server that gives Claude Desktop full access to your email through Mozilla Thunderbird. 12 high-level tools: search, read, compose, reply, attachments, folders.","maintainers":[{"name":"vitalio-sh","email":"psnukcool@gmail.com"}],"readme":"# thunderbird-cli MCP Server\n\n[![npm version](https://img.shields.io/npm/v/thunderbird-cli-mcp.svg)](https://www.npmjs.com/package/thunderbird-cli-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**MCP server that gives Claude Desktop full access to your email through Mozilla Thunderbird.**\n\nRead, search, compose, reply, and manage 22+ email accounts and 250K+ messages from any MCP-compatible client. All credentials stay in Thunderbird — nothing leaves your machine.\n\nPart of the [thunderbird-cli](https://github.com/vitalio-sh/thunderbird-cli) project.\n\n## What it does\n\nExposes 12 email management tools to Claude Desktop:\n\n| Tool | Description |\n|---|---|\n| `email_stats` | Account/folder overview, unread counts, totals |\n| `email_search` | Cross-account search (15 filter options, relative dates) |\n| `email_list` | List folder contents with sort/pagination |\n| `email_read` | Read message (5 modes: default, headers, full, raw, check-download) |\n| `email_thread` | Get full conversation thread |\n| `email_compose` | Send/draft new email (default: draft, never auto-sends) |\n| `email_reply` | Reply to message (default: draft) |\n| `email_forward` | Forward to new recipient (default: draft) |\n| `email_mark` | Read/flagged/junk flags and tags — add, remove or replace (batch supported) |\n| `email_archive` | Archive, move, or delete messages |\n| `email_attachments` | List + download attachments (base64) |\n| `email_folders` | List folders, get info, trigger sync |\n\n**Safe defaults:** compose/reply/forward all default to **draft mode**. Claude must explicitly pass `mode: \"send\"` to actually send anything. Permanent delete requires `confirm: true`.\n\n## Architecture\n\n```\nClaude Desktop ──stdio──> tb-mcp ──HTTP──> bridge daemon ──WS──> Thunderbird Extension\n                                                                      ↓\n                                                            All your email accounts\n```\n\nThe MCP server is stateless. It calls the bridge daemon which forwards to the Thunderbird WebExtension. Your email accounts stay configured in Thunderbird where they always were.\n\n## Prerequisites\n\nYou need three things running on your machine:\n\n1. **Mozilla Thunderbird 128+** with your email accounts configured\n2. **The thunderbird-cli bridge daemon** running on `127.0.0.1:7700`\n3. **The thunderbird-cli WebExtension** loaded in Thunderbird\n\nSee the [main repo setup guide](https://github.com/vitalio-sh/thunderbird-cli/blob/main/docs/SETUP.md) for installing the bridge and extension.\n\n## Installation\n\n### Option A: npx (recommended, no install)\n\nAdd to your Claude Desktop config (no installation step needed — npx fetches it on demand):\n\n```json\n{\n  \"mcpServers\": {\n    \"thunderbird\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"thunderbird-cli-mcp\"]\n    }\n  }\n}\n```\n\n### Option B: Global install\n\n```bash\nnpm install -g thunderbird-cli-mcp\n```\n\nThen in Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"thunderbird\": {\n      \"command\": \"tb-mcp\"\n    }\n  }\n}\n```\n\n### Option C: From source\n\n```bash\ngit clone https://github.com/vitalio-sh/thunderbird-cli\ncd thunderbird-cli\nnpm install\n```\n\nThen in Claude Desktop config:\n\n```json\n{\n  \"mcpServers\": {\n    \"thunderbird\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/thunderbird-cli/mcp/src/server.js\"]\n    }\n  }\n}\n```\n\n## Claude Desktop Config Location\n\n| OS | Path |\n|---|---|\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n\n## Recommended: also install the companion skill\n\nThe MCP server gives Claude *access* to the email tools. The companion [Claude Skill](https://agentskills.io) teaches Claude *how to use them well* — token-efficient `fields` selection, draft-by-default safety, trust-metadata checks, recipes for common workflows.\n\nOne command on Claude Code:\n\n```bash\ncp -r skills/thunderbird-cli ~/.claude/skills/\n```\n\nOn Claude.ai, zip and upload at **Settings → Capabilities → Skills**:\n\n```bash\ncd skills && zip -r thunderbird-cli.zip thunderbird-cli\n# upload thunderbird-cli.zip\n```\n\nFull skill docs: [`skills/thunderbird-cli/SKILL.md`](https://github.com/vitalio-sh/thunderbird-cli/blob/main/skills/thunderbird-cli/SKILL.md).\n\nSkipping the skill is fine — the MCP still works — but with it, Claude's defaults get noticeably safer (never-auto-send, junk-excluded, truncated bodies) without the user having to re-prompt.\n| Linux | `~/.config/Claude/claude_desktop_config.json` |\n\nAfter editing, **restart Claude Desktop**. You should see \"thunderbird\" in the MCP servers list when you click the tool icon.\n\n## Configuration\n\nThe MCP server reads these environment variables (set in your Claude Desktop config under `env`):\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `TB_BRIDGE_HOST` | `127.0.0.1` | Bridge daemon host |\n| `TB_BRIDGE_PORT` | `7700` | Bridge daemon HTTP port |\n| `TB_AUTH_TOKEN` | (none) | Optional auth token |\n\nExample with custom bridge host:\n\n```json\n{\n  \"mcpServers\": {\n    \"thunderbird\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"thunderbird-cli-mcp\"],\n      \"env\": {\n        \"TB_BRIDGE_HOST\": \"127.0.0.1\",\n        \"TB_BRIDGE_PORT\": \"7700\"\n      }\n    }\n  }\n}\n```\n\n## Example prompts\n\nOnce configured, try these in Claude Desktop:\n\n> \"How many unread emails do I have across all accounts?\"\n\n> \"Search for invoices from AWS in the last 30 days\"\n\n> \"Show me the thread about the GMI Cloud SCALE program\"\n\n> \"Reply to message ID 118 saying I'll be there Monday — save as draft so I can review\"\n\n> \"List all attachments on message 245 and download the PDF\"\n\n> \"Mark all messages from noreply@github.com in my inbox as read\"\n\n## Safety\n\n- **Compose/reply/forward default to draft mode.** Claude cannot send emails without explicitly requesting `mode: \"send\"`.\n- **Permanent delete is gated** behind `confirm: true`.\n- **Search excludes junk/spam by default** to prevent prompt injection from adversarial emails.\n- **All traffic stays on localhost.** Bridge listens on `127.0.0.1` only.\n- **No credentials are exposed.** Thunderbird handles all IMAP/SMTP — your passwords never leave its config.\n\nSee [SECURITY.md](https://github.com/vitalio-sh/thunderbird-cli/blob/main/SECURITY.md) for the full threat model and prompt-injection defenses.\n\n## Troubleshooting\n\n### \"Bridge unreachable\" / connection errors\n- Is the bridge daemon running on `127.0.0.1:7700`? Test: `curl http://127.0.0.1:7700/bridge/status`\n  (if the bridge was started with `TB_AUTH_TOKEN`, add `-H \"Authorization: Bearer $TB_AUTH_TOKEN\"`, or the call returns 401)\n- Is Thunderbird running with the extension loaded?\n- Check Thunderbird's add-on debugging console for WebSocket errors\n\n### Tools don't appear in Claude Desktop\n- Did you restart Claude Desktop after editing the config?\n- Check the Claude Desktop logs (View → Developer → Open Logs)\n- Verify the JSON config is valid\n\n### \"Request timed out\" on send\n- SMTP send can take 30-60s on first connection\n- The MCP server uses a 30s default — for sends, use the CLI directly with `--timeout 60000`\n\n## Development\n\n```bash\ngit clone https://github.com/vitalio-sh/thunderbird-cli\ncd thunderbird-cli\nnpm install\nnpm run test:mcp    # 34 integration tests against mock bridge\n```\n\n## License\n\nMIT — see [LICENSE](https://github.com/vitalio-sh/thunderbird-cli/blob/main/LICENSE)\n","readmeFilename":"README.md"}