roundcube-access

Automates IMAPS access to Roundcube QA mailbox to read, search and verify emails via Python CLI with PyYAML config and JSON output.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/midas44/ttt-expert-v2 --skill roundcube-access
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roundcube-access
Source: https://github.com/midas44/ttt-expert-v2/tree/main/.claude/skills/roundcube-access
Command: npx skills add https://github.com/midas44/ttt-expert-v2 --skill roundcube-access

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill enables fast, programmatic access to the Roundcube webmail QA mailbox over IMAPS for QA tasks, allowing reading, listing, searching, and validating test emails without manual UI automation.

Core Features & Use Cases

  • Read and list messages from INBOX using a lightweight Python CLI over IMAP (IMAPS) with read-only access.
  • Search across headers, body, and date fields with a variety of criteria, and read or save full messages for evidence.
  • Verify that test notifications were sent by QA jobs, inspect incoming emails, and extract data for logging or debugging.

Quick Start

Run the CLI from the repository root to list recent messages in INBOX.

Frequently Asked Questions about roundcube-access

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate reading and searching QA emails over IMAP?

You can automate reading and searching QA emails over IMAP using a standalone Python CLI that connects to an IMAPS mailbox with read-only access to list, search, and verify messages.

Can I use a Python CLI to verify test notifications sent by CI jobs?

Yes, a Python CLI can verify test notifications sent by CI jobs by searching across email headers, body, and date fields, then outputting the results as JSON or human-readable data.

What do I need to configure before accessing a Roundcube mailbox via IMAPS?

You need to provide connection details and credentials in a YAML configuration file using the PyYAML library before the CLI can access the Roundcube mailbox via IMAPS.

How do I save test email artifacts for debugging across CI runs?

You can save test email artifacts for debugging across CI runs by using the CLI to read full messages from the inbox and export the extracted data as JSON or human-readable output.

Is there a way to search Roundcube inbox content without manual UI automation?

You can search Roundcube inbox content without manual UI automation by running a lightweight Python CLI that queries the IMAP server directly using read-only access.

Does this IMAPS email tool support searching by specific headers and dates?

Yes, the IMAPS email tool supports searching across headers, body, and date fields with a variety of criteria to help validate test notifications and inspect incoming emails.