Webex Email Reminders

CLI tool that checks Webex for mentions and direct messages from the last hour and sends an email summary via Nylas.

Prerequisites

• Python 3.9+
• Nylas CLI: brew install nylas/nylas-cli/nylas

Setup

pip install webex-email-reminders

Or install from source:

pip install -r requirements.txt

Environment Variables

export WEBEX_JWT="your-webex-personal-access-token"
export NYLAS_API_KEY="your-nylas-api-key"
export NYLAS_GRANT_ID="your-nylas-grant-id"

Usage

# Send summary email
webex-email-reminders --to your@email.com

# Send to multiple recipients from a file
webex-email-reminders --to-list recipients.txt

# Both single and list
webex-email-reminders --to your@email.com --to-list recipients.txt

# Custom time window
webex-email-reminders --to your@email.com --hours 2

# Filter DMs by contacts file
webex-email-reminders --to your@email.com --contacts contacts.txt

# Dry run (prints email content without sending)
webex-email-reminders --to your@email.com --dry-run

# Include replies to threads you started
webex-email-reminders --to your@email.com --thread-replies

# Email errors instead of crashing (useful for cron jobs)
webex-email-reminders --to your@email.com --email-errors

# Check version
webex-email-reminders --version

Options

Local Development

python3 webex_reminders.py --to-list recipients.txt --hours 3

Contacts File (optional)

One email per line to filter which DMs to include:

person1@company.com
person2@company.com

Version Management

When releasing a new version, update the version in these files:

1. pyproject.toml — version = "X.Y.Z"
2. webex_reminders.py — version="%(prog)s X.Y.Z"

Then tag and deploy:

git tag vX.Y.Z
git push origin vX.Y.Z
./deploy.sh

Deploy

./deploy.sh

Crontab

Run hourly during work hours (8am–6pm EST, Mon–Fri):

0 8-18 * * 1-5 /path/to/your/reminders.sh