imap-stream-mcp

Youtube to Markdown Skill

Skip the Video - Extract the Knowledge.

Transform streaming content into storagable knowledge as Markdown.

Drop into Obsidian, Notion, or any note-taking system.

• •✨ TL;DR + structured summary: Core insights with four content specific summarization formats
• •💎 Hidden Gems: Collects insights that normal summarization loses
• •🎛️ Modular: Choose output from Everything to Summary only, Transcript only, or Comments only.
• •🧹 Cleaned transcript: Broken into chapters and paragraphs with topic headings into own file
• •🏷️ Timestamp links: Jump back to specific moments in the original video from the transcript
• •💬 Comment analysis: Curates and cross-analyzes comments against the summary

IMAP Stream MCP Server

Your Inbox, Minimal Context.

Lightweight IMAP email client. No destructive operations.

• •🪶 ~500 tokens vs typical 15,000+ MCP servers - single tool with action dispatcher
• •📧 Read & search: List, read, and search IMAP folders
• •✍️ Draft replies: Markdown converted to HTML + plain text alternatives
• •📎 Attachments: Download for further processing
• •🔐 Secure: Credentials in OS keychain (or env variables for Docker/CI)
• •🛡️ Content Safety: Encapsulates email content to avoid context poisoning
• •🏢 Multi-account: Multiple account support with named switching

Latest Release Highlights

• •youtube-to-markdown v2.15.0

- Deterministic paragraph breaks via script (was LLM subagent) — eliminates 100K+ token overhead - Watch guide: HH:MM:SS timestamps, clickable summary table, read-detail links - Transcript ← watch guide crosslinks with ▶ video links - Shorter filenames, standard markdown timestamp links

Quick Start

Installation

Add the marketplace and install:

/plugin marketplace add vre/flow-state

/plugin install youtube-to-markdown@flow-state
/plugin install imap-stream-mcp@flow-state

Usage

Youtube-to-Markdown: In your Claude Code:

extract https://www.youtube.com/watch?v=dQw4w9WgXcQ

('get', 'fetch', 'transcript', 'subtitles', 'captions', etc. works too)

IMAP-Stream-MCP: In your Claude Code:

what email accounts I have?

As you don't have any configured yet, it will show you how to set up.

Documentation

Plugins

• •youtube-to-markdown - Installation, usage, output options
• •imap-stream-mcp - Configuration, actions, multi-account setup

Design Guides (deep rationale, references)

• •Designing AGENTS.md - Behavioral configuration for AI agents
• •Designing Skills - Skill architecture, categories, distribution
• •Designing MCP Servers - MCP server design for LLM consumption
• •Designing CLI Tools - CLI tools for humans and LLMs
• •Designing Hooks - Lifecycle hooks for AI coding agents

Writing Guides (LLM-optimized, condensed)

• •Writing CLAUDE.md - Condensed CLAUDE.md/AGENTS.md principles
• •Writing Skills - Condensed SKILL.md principles
• •Writing MCP Servers - MCP server design for LLM consumers
• •Writing CLI Tools - CLI tool design for humans and LLMs
• •Writing Model-Specific Prompts - Prompt tuning per model family

Examples of Youtube to Markdown Output

All examples are CC-licensed videos with full summary and comment analysis.

The Backstory

I have been thinking a while to extract YouTube transcripts into Markdown format for my Obsidian vault. I knew of yt-dlp, but I wanted something more that would clean, format, summarize, analyze etc. LocalLlama was one option but never got the time.. Finally as checking out Claude Code skills in wild I thought that maybe there would be something already Done for Me. Well there was not, but I found one youtube skill to build upon. Four months later I added IMAP email access as well, as I wanted to have email reading and drafting capabilities in Claude Code in lightweight manner.

Many ideas for the future - maybe knowledge work, context management, and productivity tools for Claude Code and beyond. Let's see where this goes and is there time for it..

Development

See DEVELOPMENT.md.

License

MIT, See LICENSE for more information.