check-email

Retrieve and filter Gmail emails via IMAP into structured Notes.

10|Updated Jul 22, 2025

Search Tags:#automation #search #email #gmail #fetch #imap

Ready to run

npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill check-email

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: check-email
Source: https://github.com/bdambrosio/Cognitive_workbench/tree/main/src/tools/check-email
Command: npx skills add https://github.com/bdambrosio/Cognitive_workbench --skill check-email

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows you to programmatically access and search your Gmail inbox, enabling automated processing of emails without manual intervention.

Core Features & Use Cases

Email Retrieval: Fetch emails from specified IMAP folders (e.g., INBOX, Sent, Drafts).
Advanced Filtering: Filter emails by sender, subject, date range, and full-text search queries.
Use Case: Automatically scan your inbox for emails containing "invoice" in the subject line from the last week, extract their content, and summarize the key details.

Quick Start

Check your inbox for the 5 most recent emails and output them.

Frequently Asked Questions about check-email

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

FAQPage Schema

How do I fetch emails from Gmail using IMAP automation?▼

To fetch emails from Gmail using IMAP automation, this Skill retrieves messages by connecting with your GMAIL_ADDRESS and GMAIL_APP_PASSWORD environment variables, parsing headers and bodies into structured Notes for further processing.

Can I filter Gmail inbox searches by sender, subject, or date range?▼

You can filter Gmail inbox searches by sender, subject, date range, folder, and full-text query. The Skill applies these IMAP search criteria to retrieve specific emails and parse their content into structured output.

Do I need an app password to automate Gmail inbox retrieval?▼

You need a GMAIL_APP_PASSWORD and GMAIL_ADDRESS environment variable to automate Gmail inbox retrieval. Standard password authentication is not supported; an app password is required for IMAP access.

What is the best way to automatically extract invoice emails from Gmail?▼

The best way to extract invoice emails from Gmail is using full-text or subject filtering via IMAP. You can filter for "invoice" in the subject line, limit by date range, and parse the email bodies into structured Notes.

Does IMAP email retrieval work with Gmail folders other than the inbox?▼

IMAP email retrieval works with Gmail folders other than the inbox. You can specify folders like Sent or Drafts to fetch and parse emails from any available IMAP folder in your account.

How are parsed email bodies structured after Gmail IMAP retrieval?▼

Parsed email bodies and headers are structured into Notes after Gmail IMAP retrieval. This format allows downstream processing of the extracted email content, enabling automated analysis of the retrieved messages.