skills.rest
dmoraine
dmoraineCOMMUNITY
Explore all skills by this author →
GitHub

claw-inbox-rag

Query Gmail data via natural-language commands against a local RAG stack.

1|Updated Feb 10, 2026
Search Tags:#rag#gmail#parser#read-only#mail#wrapper
One-click install
npx skills add https://github.com/dmoraine/ClawInboxRAG --skill claw-inbox-rag
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claw-inbox-rag
Source: https://github.com/dmoraine/ClawInboxRAG/tree/main
Command: npx skills add https://github.com/dmoraine/ClawInboxRAG --skill claw-inbox-rag

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill enables safe, read-only mailbox retrieval by querying a local Gmail RAG stack with natural-language "mail ..." commands, returning concise results with citations and no mailbox state changes.

Core Features & Use Cases

  • Read-only mailbox search and status using the local Gmail RAG backend.
  • Passthrough commands like mail labels and mail recents when supported by the backend.
  • Safe, bounded outputs with token privacy and simple setup for local testing.
  • Use case: locate a specific invoice and obtain a stable permalink to the message.

Quick Start

Install the skill, configure GMAIL_RAG_REPO and token path, and run a sample query such as "mail invoices max 3".

Frequently Asked Questions about claw-inbox-rag

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

FAQPage Schema
How do I query Gmail data locally using natural language commands?▼

You can query Gmail data locally by using natural language 'mail ...' commands through a read-only Gmail RAG stack, which retrieves concise results with citations without altering mailbox state.

What is a read-only Gmail RAG stack and how does it protect my mailbox?▼

A read-only Gmail RAG stack queries your mail data using a local backend and a restricted token, ensuring no mailbox state changes while providing bounded outputs and protecting secret credentials.

Do I need a FAISS index to perform semantic search on Gmail messages?▼

Yes, a FAISS index is required for semantic or hybrid search across your Gmail data, working in conjunction with a local backend checkout and a read-only Gmail token to process 'mail ...' queries.

How do I filter Gmail RAG queries by date, label, or sender?▼

You can filter Gmail RAG queries by applying optional date, label, and sender or recipient filters directly within your natural language 'mail ...' commands to bound the search results.

Can I retrieve specific email invoices with stable permalinks from a local mail search?▼

Yes, you can locate specific invoices and obtain a stable permalink to the message by running a targeted query like 'mail invoices max 3' against the local Gmail RAG backend.

What are the limitations of using a local Gmail RAG wrapper for mailbox search?▼

Limitations include requiring a local backend checkout pointed by GMAIL_RAG_REPO and a read-only token, meaning the Skill cannot modify mailbox state and outputs are strictly bounded for safety.

Related Skills

Explore More Software Engineering Skills→
AbilityaiAbilityai
103

refresh-index

Rebuild the FAISS vector index for updated semantic search accuracy.

Official
Basic
hmzainjamilhmzainjamil
1

gmail-workflows

Automate Gmail inbox workflows by extracting attachments, applying labels, and syncing files to Google Drive.

Community
Advanced
EndUser123EndUser123

cks

Store and semantically search project knowledge locally with a FAISS-backed index.

Community
Advanced
agilebydesignagilebydesign
1

abd-embed-vectors

Embed Markdown text chunks into a local FAISS vector index via the OpenAI API.

Official
Intermediate