agentCLAWHUBUnverified

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

OpenClaw

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
  1. Install using `clawhub skill install s174t07mepg1ydqaj7m9s718nd84kj50:thunderbird` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. 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.
Github ReposUpdated 1d agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

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.

Sponsored

Ads related to Thunderbird and adjacent AI workflows.