google-skill

google-skill

Full Google services integration for Claude Code: Gmail, Calendar, Sheets, Docs, and YouTube.

Features

• Gmail: Read, send, search emails. Manage labels. Download as EML. HTML emails with attachments. Send markdown as styled HTML emails with Focus.AI branding.
• Calendar: List, create, delete events. Multiple calendar support.
• Sheets: Create spreadsheets, read/write cells, append rows.
• Docs: Create documents, read content, insert/append text, find/replace. Export to PDF, Word, ODT, and more.
• YouTube: Search, list videos/channels/playlists, view comments.
• YouTube (yt-dlp): Download videos, extract transcripts, list any channel's videos, create channel summaries.

All services share a single OAuth authentication. yt-dlp features work without OAuth.

Installation

Via Focus Marketplace (Recommended)

# Add the Focus marketplace (if not already added)
/plugin marketplace add The-Focus-AI/claude-marketplace

# Install the plugin
/plugin install google-skill@focus-marketplace

Then restart Claude Code.

Direct Install

/plugin install https://github.com/The-Focus-AI/google-skill

For yt-dlp Features

brew install yt-dlp

First-Time Setup

After installation, run:

npx tsx scripts/gmail.ts auth

If this is your first time, you'll see setup instructions to create Google OAuth credentials. This is a one-time setup stored in `~/.config/google-skill/`.

Required Google APIs

Enable these APIs in Google Cloud Console:

• Gmail API
• Google Calendar API
• Google Sheets API
• Google Docs API
• YouTube Data API v3
• Google Drive API

OAuth Scopes

The skill requests these scopes:

• Gmail: read, send, modify
• Calendar: read, events
• Sheets: full access
• Docs: full access
• YouTube: read, upload
• Drive: read-only (for listing files)

Token Storage

~/.config/google-skill/

...