Manage your Ridwell recycling account directly through Claude Code.

• View upcoming pickups and items
• Opt in/out of pickup events
• Check special/rotating categories
• Get answers about what Ridwell accepts
• Account status information

• Ridwell account with active subscription
• Environment variables configured

The skill includes a pre-configured virtual environment with all dependencies. No pip install needed.

Add to your shell profile (~/.zshrc or ~/.bashrc):

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

Then reload:

source ~/.zshrc

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

You should see your account information in JSON format.

Note: Call the script directly without python prefix - it uses the built-in venv.

Once configured, just ask Claude naturally:

• "What's my next Ridwell pickup?"
• "Opt me into the next pickup"
• "What special categories are available?"
• "Does Ridwell take styrofoam?"
• "Skip my next Ridwell pickup"

~/.claude/skills/ridwell/
├── SKILL.md              # Main skill instructions
├── README.md             # This file
├── scripts/
│   ├── ridwell_client.py # API wrapper
│   ├── requirements.txt  # Python dependencies
│   └── __init__.py
└── references/
    ├── what-we-take.md   # Accepted items reference
    ├── faqs.md           # Common questions
    └── api-reference.md  # Command reference

The Ridwell API does not support:

• Changing special category selections
• Modifying item quantities

Use the Ridwell website or app for these actions.

pip install aioridwell

Set the environment variables as described in Installation step 2.

Verify your email and password are correct for your Ridwell account.

• Ridwell support: help@ridwell.com
• aioridwell library: https://github.com/bachya/aioridwell