Ridwell Integration

Your complete interface for managing Ridwell recycling pickups and understanding what they accept.

What This Skill Does

Pickup Management: View upcoming pickups, opt in/out of events
Special Categories: See what rotating/featured categories are coming
Item Classification: Answer "does Ridwell take X?" questions
Account Info: Check account status and subscription details

Quick Reference

IMPORTANT: The script uses a built-in virtual environment. Call the script directly (do NOT use python or python3 prefix):

Check Pickups

# Next pickup with items
~/.claude/skills/ridwell/scripts/ridwell_client.py next

# All upcoming pickups
~/.claude/skills/ridwell/scripts/ridwell_client.py pickups

# Featured categories for each pickup (with alternatives)
~/.claude/skills/ridwell/scripts/ridwell_client.py featured

Opt In/Out

# First get the event ID from pickups command, then:
~/.claude/skills/ridwell/scripts/ridwell_client.py opt-in <event_id>
~/.claude/skills/ridwell/scripts/ridwell_client.py opt-out <event_id>

Account Info

~/.claude/skills/ridwell/scripts/ridwell_client.py account

Item Classification

When users ask "does Ridwell take X?", refer to what-we-take.md.

Core Categories (Always Accepted)

Plastics: Multi-layer plastic, film, caps, clamshells, pill bottles, bread tags
Clothing: Worn textiles, clothes, shoes
Electronics: Small electronics, cables, batteries, lightbulbs
Household: Corks, kitchenware, latex paint, styrofoam, glass

Rotating Categories

Change quarterly. Run the special command to see current options.

NOT Accepted

Hazardous materials (chemicals, solvents, motor oil)
Medical waste (needles, medications)
Food waste
Construction debris
Large appliances

Common User Questions

"What's my next Ridwell pickup?"

Run the next command and summarize the date and items.

"Opt me into the next pickup"

Run next to get the event_id
Run opt-in <event_id>
Confirm success

"What special category is coming up?"

Run the special command and list the rotating categories with their dates.

"Does Ridwell take [item]?"

Check what-we-take.md
If item is in a core category, yes
If unclear, suggest checking ridwell.com/what-we-take for their address

"How do I [process question]?"

Refer to faqs.md for common procedures.

Setup Requirements

Environment Variables (must be set in ~/.zshrc):

export RIDWELL_EMAIL="your@email.com"
export RIDWELL_PASSWORD="your-password"

Python Package: Already installed in the skill's virtual environment at ~/.claude/skills/ridwell/.venv/. No additional installation needed.

API Limitations

This skill CANNOT:

Change which special/rotating category you've selected
Modify item quantities
Create new pickup events

These actions require the Ridwell website or app.

Reference Files

what-we-take.md - Items Ridwell accepts
faqs.md - Common pickup questions
api-reference.md - Script command reference

Examples

User: "When is my next Ridwell pickup?" Action: Run next command, report date and items

User: "I want to skip the next pickup" Action: Run next to get event_id, then opt-out <event_id>

User: "Can I recycle chip bags with Ridwell?" Answer: Yes, chip bags are multi-layer plastics, a core category

User: "What's the featured category this month?" Action: Run featured command, report the featured category for each upcoming pickup

User: "What are my next featured categories?" Action: Run featured and summarize:

Jan 6: Essential hygiene items
Jan 20: Holiday lights
Feb 3: Empty Play-Doh Containers
etc.

User: "What alternatives can I choose instead?" Action: The featured output shows alternatives like: Bottle caps, Cords/chargers, Portable devices, Corks, Pill bottles, Bread tags

User: "Does Ridwell take motor oil?" Answer: No, Ridwell does not accept hazardous materials like motor oil