email-summary

# Email Summary Skill

This skill fetches recent emails from your Gmail account and provides AI-powered summaries.

## How it works

When invoked, this skill will:

1. **Authenticate with Gmail API** using credentials at `$GMAIL_CREDENTIALS_PATH`
2. **Fetch recent emails** (default: last 10 unread emails)
3. **Summarize each email** with:
   - Sender and subject
   - Key points from the email body
   - Recommended actions or responses
4. **Present results** in an organized, easy-to-scan format

## Instructions for the Agent

When this skill is invoked:

1. First, verify that the Gmail API credentials exist at the path specified in `$GMAIL_CREDENTIALS_PATH` environment variable
2. Run the helper script located at `{baseDir}/scripts/fetch_emails.py` with the appropriate arguments:
   - Default: `python3 {baseDir}/scripts/fetch_emails.py --count 10`
   - With arguments: `python3 {baseDir}/scripts/fetch_emails.py $ARGUMENTS`
3. Parse the JSON output from the script
4. For each email, provide a concise summary including:
   - **From**: Sender name and email
   - **Subject**: Email subject line
   - **Summary**: 2-3 sentence summary of key points
   - **Action**: Suggested action (reply, archive, flag for follow-up, etc.)
5. Present all summaries in a well-formatted list

## Usage Examples

```
/email-summary
```
Fetches and summarizes the last 10 unread emails.

```
/email-summary --count 20
```
Fetches and summarizes the last 20 unread emails.

```
/email-summary --all
```
Fetches and summarizes all unread emails.

## Setup Requirements

Before using this skill, ensure:
- Gmail API credentials are configured
- Environment variable `GMAIL_CREDENTIALS_PATH` points to your credentials JSON file
- Python 3 and required packages are installed (see setup guide in README.md)

# Email Summary Skill for OpenClaw

AI-powered email summarization skill that fetches your Gmail messages and provides concise, actionable summaries.

## Features

- Fetch recent unread emails from Gmail
- AI-generated summaries with key points
- Suggested actions for each email
- Configurable number of emails to fetch
- Secure OAuth2 authentication

## Installation

### 1. Install Python Dependencies

```bash
pip install google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client
```

### 2. Set Up Gmail API Credentials

1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Create a new project (or select an existing one)
3. Enable the Gmail API:
   - Navigate to "APIs & Services" > "Library"
   - Search for "Gmail API"
   - Click "Enable"
4. Create OAuth2 credentials:
   - Go to "APIs & Services" > "Credentials"
   - Click "Create Credentials" > "OAuth client ID"
   - Choose "Desktop app" as application type
   - Download the credentials JSON file
5. Save the credentials file to a secure location (e.g., `~/.config/gmail/credentials.json`)

### 3. Set Environment Variable

Add this to your shell configuration (`~/.zshrc`, `~/.bashrc`, etc.):

```bash
export GMAIL_CREDENTIALS_PATH="$HOME/.config/gmail/credentials.json"
```

Reload your shell:
```bash
source ~/.zshrc  # or ~/.bashrc
```

### 4. Install the Skill

**Option A: Install to OpenClaw local skills**
```bash
cp -r email-summary ~/.openclaw/skills/
```

**Option B: Install to workspace**
```bash
# In your OpenClaw workspace directory
cp -r email-summary ./skills/
```

## First-Time Setup

The first time you run the skill, you'll need to authorize access:

1. A browser window will open automatically
2. Sign in to your Google account
3. Grant permissions to access Gmail (read-only)
4. The authorization token will be saved for future use

## Usage

In OpenClaw, use the `/email-summary` command:

### Fetch last 10 unread emails (default)
```
/email-summary
```

### Fetch specifi...