skills.rest
mycelium-hq
mycelium-hqOFFICIAL
Explore all skills by this author →
GitHub

ingest-gmail

Convert Gmail label or query results into daily markdown vault files.

31|20|Updated Apr 9, 2026
Search Tags:#automation#markdown#gmail#ingestion#vault#data-security
One-click install
npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-gmail
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ingest-gmail
Source: https://github.com/mycelium-hq/ai-brain-starter/tree/main/skills/ingest-gmail
Command: npx skills add https://github.com/mycelium-hq/ai-brain-starter --skill ingest-gmail

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ingest Gmail messages into the vault as queryable markdown, enabling memory, traceability, and decision making across conversations by surfacing email content in the knowledge graph.

Core Features & Use Cases

  • Ingests recent Gmail messages matching a label or free-text Gmail query into vault Markdown objects the graph can read.
  • Writes to External Inputs/Gmail/<scope>/<YYYY-MM-DD>.md, applying 500-char body truncation to protect PII.
  • Idempotent: re-running on the same day overwrites the day's vault file, preserving a clean history.
  • Do NOT use for sending email, replying, or non-Gmail sources.

Quick Start

Ingest Gmail messages by label or query with /ingest-gmail <label-or-query> [--days N] to populate the vault.

Frequently Asked Questions about ingest-gmail

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

FAQPage Schema
How do I convert Gmail messages to markdown for a knowledge graph?▼

You can convert Gmail messages to markdown by ingesting label-filtered or free-text Gmail queries into the vault. The tool writes daily markdown files to External Inputs/Gmail/<scope>/<YYYY-MM-DD>.md, making email content queryable in the knowledge graph.

Can I ingest Gmail emails into a vault using a specific label or search query?▼

Yes, you can ingest Gmail emails using a specific label or free-text search query. The ingestion process requires input payloads containing the label_or_query, scope_kind, days, and vault_root parameters to filter and route the messages correctly.

How do I automate daily Gmail ingestion into markdown without creating duplicate files?▼

Automating daily Gmail ingestion into markdown is idempotent because the tool overwrites the day's vault file on repeated invocations. Re-running the ingestion process for the same day preserves a clean history without creating duplicate markdown files.

Does the Gmail to markdown ingestion process truncate email bodies for data security?▼

Yes, the Gmail to markdown ingestion process truncates email bodies to 500 characters to protect PII. This data security measure ensures that sensitive information is minimized when surfacing email content in the knowledge graph.

When should I not use a Gmail ingestion tool for email processing?▼

You should not use a Gmail ingestion tool for sending email, replying to messages, or processing non-Gmail sources. It is specifically designed to ingest existing Gmail messages into a vault as queryable markdown for memory and traceability.

Related Skills

Explore More Software Engineering Skills→
MattVOLTAMattVOLTA
4

receipts

Scan Gmail for purchase emails, upload receipts to Google Drive, and notify accounting.

Community
Intermediate
aydamdonellyaydamdonelly

sync-memory

Store confirmed facts and decisions into a shared memory Knowledge Graph.

Community
Intermediate
danmestasdanmestas
4

knowledge-base

Manage a persistent vault-based knowledge graph with Obsidian-compatible markdown tooling.

Community
Advanced
gnestorgnestor

gmail

Lists unread or important Gmail messages, applies labels, archives, and creates Notion tasks.

Community
Advanced