Thunderbird
Read and search local Mozilla Thunderbird mail storage on disk. Use when working with Thunderbird profiles, extracting emails from local folders or IMAP cach...
Rank
62
Safety
84
Downloads
1.3k
Updated
Oct 10, 2026
Version
0.1.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.3K downloadsadoption · observed Oct 10, 2026
- Latest release
- 0.1.1release · observed Mar 12, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s174t07mepg1ydqaj7m9s718nd84kj50:thunderbird- Install using `clawhub skill install s174t07mepg1ydqaj7m9s718nd84kj50:thunderbird` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/komelt/thunderbird before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-komelt-thunderbird/snapshot"
Documentation
CLAWHUB
24,384 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: thunderbird description: Read and search local Mozilla Thunderbird mail storage on disk. Use when working with Thunderbird profiles, extracting emails from local folders or IMAP cache, locating messages by sender/recipient/subject/body, checking which account a mailbox belongs to, or answering inbox questions for a specific Thunderbird account such as "do I have unread mail today?" or "search mail for [email protected]". --- # Thunderbird Use Thunderbird's local profile data as the source of truth for offline mail inspection. Prefer read-only access and search the raw local storage directly rather than relying on UI automation. Run the bundled script from the skill directory, or use an absolute path resolved from the skill root: - `python scripts/search_thunderbird.py ...` If the current working directory is not the skill directory, resolve `scripts/search_thunderbird.py` relative to this `SKILL.md` location before running it. ## Quick start 1. Detect available profiles: - `python scripts/search_thunderbird.py --list-profiles` 2. List accounts in one profile: - `python scripts/search_thunderbird.py --profile default-release --list-accounts` 3. Search one mailbox account directly: - `python scripts/search_thunderbird.py --profile default-release --account [email protected] --folder inbox --query invoice --limit 10` 4. Narrow content search when needed: - `--subject-only` to search only the subject line - `--body-only` to search only the body/preview text - `--exclude <text>` to remove noisy matches 5. Return only unread inbox messages when needed: - `python scripts/search_thunderbird.py --profile default-release --account [email protected] --folder inbox --unread-only --limit 20` 6. Extract, filter, or sort more when needed: - `--show-body` - `--unread-only` - `--subject-only` - `--body-only` - `--exclude wordpress` - `--has-attachment` - `--attachment-name invoice` - `--list-attachments` - `--save-attachments ./out` - `--today` - `--yesterday` - `--since 2026-03-11` - `--until 2026-03-12T08:00:00+01:00` - `--sort-by date|from|subject|to` - `--sort-order asc|desc` - `--json` ## Workflow ### 1. Pick the profile Use `--list-profiles` first if the profile is unknown. The script now checks common Thunderbird profile roots on Windows and Linux automatically. Accept either: - absolute profile path - exact profile directory name - unique profile-name fragment If multiple profiles match, stop and choose explicitly. ### 2. Pick the account when possible For account-specific requests, do not scan every mailbox first. Use: - `--list-accounts` to inspect the profile - `--account <email-or-fragment>` to restrict work to one Thunderbird account - `--folder inbox|sent|archive|drafts|junk|trash|spam` to narrow further This is usually both faster and easier than scanning the whole profile. ### 3. Search local storage Use `scripts/search_thunderbird.py` for most tasks. It
README.md
# Thunderbird Skill for OpenClaw Search and inspect local Mozilla Thunderbird mail storage directly from disk (mbox and Maildir), with filters for account, folder, sender, recipient, subject, body, unread state, time ranges, and attachments. ## ClawHub - https://clawhub.ai/KomelT/clawhub-thunderbird-skill ## Features - Detect Thunderbird profiles on Windows and Linux profile roots - List accounts from `prefs.js` - Search local mail in `Mail/` and `ImapMail/` - Filter by sender, recipient, subject, folder, free-text query, unread status - Filter by day or time range (`--today`, `--yesterday`, `--since`, `--until`) - Filter and export attachments (`--has-attachment`, `--attachment-name`, `--save-attachments`) - Output as table-like text or JSON ## Quick start Run from the skill directory: ```powershell python scripts/search_thunderbird.py --list-profiles python scripts/search_thunderbird.py --profile default-release --list-accounts python scripts/search_thunderbird.py --profile default-release --account [email protected] --folder inbox --query invoice --limit 20 ``` Search by attachment name and save files: ```powershell python scripts/search_thunderbird.py --profile default-release --attachment-name invoice --save-attachments .\out --limit 10 ``` ## Date filter behavior - `--since YYYY-MM-DD` starts at `00:00:00` UTC of that date - `--until YYYY-MM-DD` ends at `23:59:59.999999` UTC of that date - ISO-8601 timestamps are used exactly as provided ## Project files - `SKILL.md`: skill usage instructions - `scripts/search_thunderbird.py`: local Thunderbird search CLI - `references/storage-layout.md`: Thunderbird storage reference - `LICENSE`: MIT license
_meta.json
{
"ownerId": "kn7acy5qc9v8h6ang80wg9n2v982rxtt",
"slug": "thunderbird",
"version": "0.1.1",
"publishedAt": 1773310313024
}references/storage-layout.md
# Thunderbird storage layout Use this reference when inspecting local Thunderbird mail storage. ## Common Windows profile location - `%APPDATA%\Thunderbird\Profiles\<profile>` Detected examples on this machine can be discovered with: ```powershell Get-ChildItem "$env:APPDATA\Thunderbird\Profiles" ``` ## Common mail storage roots inside a profile - `Mail/` — local folders and POP accounts, usually mbox-style files - `ImapMail/` — IMAP account caches, often also mbox-style files ## Mbox indicators Thunderbird commonly stores folders as mbox files: - folder file with no extension, e.g. `Inbox`, `Sent`, `Archives` - sidecar `.msf` index file, e.g. `Inbox.msf` - optional `.sbd/` directory for subfolders Read the raw folder file as an mbox mailbox. Ignore `.msf` files for message extraction. ## Maildir indicators Some setups may use Maildir-style storage. Look for directories containing: - `cur/` - `new/` - `tmp/` Read those with Python's `mailbox.Maildir`. ## Practical cautions - Prefer read-only access. - Thunderbird may keep some files open while running; if a mailbox looks inconsistent, retry after Thunderbird sync settles or after closing Thunderbird. - Search results are only as current as Thunderbird's locally cached messages. - Ignore `.mozmsgs` directories unless specifically extracting Spotlight/Windows search helper data.
skill-card.md
## Description: Read and search local Mozilla Thunderbird mail storage on disk. Use when working with Thunderbird profiles, extracting emails from local folders or IMAP cache, locating messages by sender/recipient/subject/body, checking which account a mailbox belongs to, or answering inbox questions for a specific Thunderbird account such as "do I have unread mail today?" or "search mail for [email protected]". This skill is ready for commercial/non-commercial use. ## Publisher: [komelt](https://clawhub.ai/user/komelt) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agents use this skill to inspect local Thunderbird profiles, find messages by account, folder, sender, recipient, subject, body, unread state, date range, or attachment, and summarize or export matching local mail artifacts. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The skill can expose sensitive local email content and metadata. Mitigation: Use the narrowest profile, account, folder, query, and date filters possible, and avoid placing full bodies or JSON output in shared logs. Risk: Saving or opening email attachments can introduce normal email-attachment malware risk. Mitigation: Save attachments only to an intended location and open unknown attachments only when the user accepts that risk. Risk: IMAP results may omit messages that are not present in Thunderbird's local cache. Mitigation: Tell users when results come from local cache and may not represent the full server mailbox. ## Reference(s): - [Thunderbird storage layout](references/storage-layout.md) - [ClawHub skill page](https://clawhub.ai/komelt/skills/thunderbird) ## Skill Output: **Output Type(s):** [text, markdown, JSON, shell commands, guidance, files] **Output Format:** [Markdown guidance with inline shell commands; CLI results as table-like text or JSON.] **Output Parameters:** [1D] **Other Properties Related to Output:** [May write saved attachment files when the user explicitly requests attachment export.] ## Skill Version(s): 0.1.1 (source: server release evidence) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/komelt/skills/thunderbird",
"sourceUrl": "https://clawhub.ai/komelt/skills/thunderbird",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T20:59:54.369Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-komelt-thunderbird/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-komelt-thunderbird/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T20:59:54.369Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/komelt/thunderbird",
"sourceUrl": "https://clawhub.ai/komelt/thunderbird",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T20:59:54.369Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.1",
"href": "https://clawhub.ai/komelt/thunderbird",
"sourceUrl": "https://clawhub.ai/komelt/thunderbird",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-03-12T10:11:53.024Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-komelt-thunderbird/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-komelt-thunderbird/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.1",
"description": "Thunderbird skill 0.1.1 introduces attachment search and improves profile discovery. - Added support for searching, listing, and saving email attachments (`--has-attachment`, `--attachment-name`, `--list-attachments`, `--save-attachments`) - Updated documentation with new attachment-related options and usage examples - Enhanced profile auto-discovery for both Windows and Linux - Clarified date interpretation for `--since` and `--until` options - Added new guidance on attachment interaction policy in the documentation - New README.md file included",
"href": "https://clawhub.ai/komelt/thunderbird",
"sourceUrl": "https://clawhub.ai/komelt/thunderbird",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-03-12T10:11:53.024Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
