Secure, per-user semantic email search across Gmail, Outlook, and IMAP histories.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install igpt-email-intelligence
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install igpt-email-intelligence using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is iGPT Email Search?
iGPT Email Search is a robust retrieval tool built for developers looking to add deep inbox intelligence to their Openclaw Skills library. It utilizes the iGPT API to provide a hybrid search engine that combines semantic vector search with traditional keyword matching. This allows AI agents to understand the intent behind a search, finding relevant threads based on meaning and context rather than just matching characters. By indexing the full email history, it overcomes the limitations of standard provider-specific searches, offering a unified interface for all connected email datasources.
iGPT Email Search Use Cases
- Locating specific project updates or board meeting notes without needing exact keywords.
- Retrieving historical correspondence within a precise date range for audit or context gathering.
- Identifying all relevant communications from a specific person or department like legal.
- Feeding high-relevance email content into secondary agent steps for summarization or task extraction.
How iGPT Email Search Works
- The agent initializes the iGPT Python SDK using a secure API key assigned to the Openclaw Skills environment.
- The user completes a one-time OAuth authorization to connect their Gmail, Outlook, or IMAP account.
- A search query is sent to the iGPT recall search endpoint, which performs a hybrid semantic-keyword lookup.
- The system retrieves ranked results from the isolated user index, ensuring no cross-user data access.
- The skill returns structured email data, including thread content and attachment references, for the agent to utilize.
iGPT Email Search Setup
First, install the required Python package:
pip install igptai
Then, configure your authentication by setting your API key as an environment variable:
export IGPT_API_KEY="your-api-key-here"
Ensure the target user has authorized their email datasource via the iGPT dashboard or API.
iGPT Email Search Data Schema & Taxonomy
The skill processes search requests and returns ranked message objects. The following parameters define the search schema:
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | The natural language or keyword query |
| user | string | Yes | Unique identifier to scope the search to a specific user |
| date_from | string | No | Start date filter (YYYY-MM-DD) |
| date_to | string | No | End date filter (YYYY-MM-DD) |
| max_results | integer | No | Maximum number of results to return (default is ranked by relevance) |
iGPT Email Search Advanced Features
- Hybrid Retrieval Engine: Combines vector-based semantic understanding with exact keyword matching for maximum accuracy.
- Per-User Data Isolation: Security is enforced at the index level, ensuring complete privacy between different users.
- Cross-Provider Support: Unified search syntax that works identically across Gmail, Outlook, and standard IMAP.
- Semantic Participant Awareness: Understands queries about specific people or roles without requiring exact email addresses.
- Developer-Friendly Error Handling: Uses a no-throw pattern for more resilient agent workflows within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
iGPT Email Ask
A secure AI reasoning skill that analyzes email conversations to extract tasks, summarize threads, and detect sentiment via the iGPT Context Engine.
reMarkable Tablet
Bridge your reMarkable tablet to your AI workspace to browse, search, and OCR handwritten notes seamlessly.
Groq Completion
A high-performance AI inference skill that connects your agent to Groq's ultra-fast LPU-powered API for near-instant completions.
Groq Completion
A high-performance integration that leverages Groq's LPU technology for near-instantaneous AI text generation and completions.
iGPT Email Search
A secure, per-user-isolated semantic search tool for retrieving relevant emails and threads from Gmail, Outlook, or IMAP via the iGPT API.
PvE Prediction Market Trading
An AI agent skill for trading prediction markets using real-time OSINT intelligence and social signals with virtual currency.
METADATA
Featured*
