manage-gmaillisted

> **Path Convention**: All paths in this document are relative to this skill's root directory. When executing commands, first `cd` to the skill directory or adjust paths accordingly. <objective> Enable Claude Code to access and process Gmail messages using the Gmail API. This skill provides functions to authenticate, list messages, read message content, send new emails with file attachments, reply to messages, forward messages, and manage drafts. </objective> <context> <credentials> OAuth 2.0 credentials are stored at: `~/.google-skills/gmail/GMailSkill-Credentials.json` Token file (generated after first authentication): `~/.google-skills/gmail/gmail_token.json` **First-time authentication**: Running any Gmail operation for the first time will open a browser window for OAuth consent. The user must grant permission to access their Gmail account. </credentials> <contacts_registry> **Contacts Registry**: `~/.google-skills/gmail/contacts-registry.json` A JSON-based registry for storing email contacts. Allows looking up email addresses by name using case-insensitive partial matching. The registry stores contacts with their full name and email address. When searching, typing "john" will match "John Smith", "Johnny Doe", etc. </contacts_registry> <scopes> Available Gmail API scopes (configured in credentials): | Scope | Purpose | |-------|---------| | `gmail.readonly` | Read-only access to messages | | `gmail.send` | Send emails | | `gmail.compose` | Create and manage draft