Skip to content
TakoAPI
Back to skills

igpt-email-intelligence

by sammy-spk

Search & Research
—Not yet rated
Your rating

Brief

Secure, per-user-isolated semantic email search via the iGPT API.

Description

What This Skill Does

Hybrid semantic and keyword email search across a user's Gmail, Outlook, or IMAP inbox via the iGPT API. Queries are scoped per user and results are ranked by relevance, covering the full indexed email history. Retrieval only — for summarization or structured extraction, use the companion igpt-email-ask skill.

Semantic vector search finds conceptually related emails even when exact keywords don't appear, and works across Gmail, Outlook, and IMAP simultaneously rather than being locked to one provider.

When to Use It

  • Find emails about a project when you can't recall exact subject lines
  • Pull all correspondence with a contact before a meeting
  • Retrieve invoices or receipts from a specific quarter
  • Check what was agreed in past threads before drafting a reply
  • Locate emails mentioning deadlines across a bounded date range

Example Workflow

INPUT

User asks: Find recent emails about the Acme Corp contract negotiation

AGENT
  1. 1

    Initialize IGPT client with IGPT_API_KEY and user identifier

  2. 2

    Call igpt.recall.search() with query 'Acme Corp contract negotiation'

  3. 3

    Apply date_from filter to scope results to recent months

  4. 4

    Receive ranked list of matching threads with relevance scores

  5. 5

    Return results for review or pass to igpt-email-ask for analysis

OUTPUT

A ranked list of email threads related to the Acme Corp contract negotiation, ordered by semantic relevance

Requirements

  • IGPT_API_KEY environment variable (obtain at igpt.ai/hub/apikeys/)
  • Email account connected via OAuth through iGPT (Gmail, Outlook, or IMAP)

Installation

clawhub install sammy-spk/igpt-email-intelligence

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links