name: gmail-exporter description: Export Gmail message metadata to JSONL using OAuth. Use when you need to pull headers, labels, and snippets for downstream classification, auditing, or cleanup workflows.

Gmail Exporter

Name: gmail-exporter
Rating: 88
Author: alishas3-singh

Quick start

•Confirm explicit consent to read Gmail.
•Ensure Gmail API is enabled and OAuth credentials are ready (see references/gmail-api-setup.md).
•Run scripts/gmail_export_metadata.py with a Gmail query and output path.
•Hand the JSONL output to downstream skills.

Safety rules

•Use least-privilege scopes (gmail.readonly).
•Avoid storing message bodies unless absolutely required.
•Keep credentials.json and token.json out of source control.

Resources

•scripts/gmail_export_metadata.py: Export metadata to JSONL.
•scripts/gmail_api.py: OAuth helper.
•references/gmail-api-setup.md: OAuth setup steps and scopes.
•references/data-schema.md: Metadata schema definition.