Gumroad
Purpose
Read-only access to the user's Gumroad account: list products and view recent sales. Use when the user mentions Gumroad, asks about Gumroad sales, or wants to see their Gumroad products. Prices are reported in USD (the API returns cents; the CLI converts). This connector cannot change anything.
Tooling
All commands go through bin/gumroad.py:
bashbin/gumroad.py auth # verify the connection bin/gumroad.py products # list products bin/gumroad.py sales --limit 20 # recent sales
Auth
- Provider id:
gumroad(credential is collected ascustom.gumroad) - Collection: API key via the secure credential flow (
credentials.request_api_access) - Token: generated at app.gumroad.com/settings/advanced#application-form. Personal tokens have full account access; this skill is read-only regardless.
- Allowed hosts:
api.gumroad.com - Status check:
bin/gumroad.py auth(must return"ok": true) - Connect placement:
bearer_header
Operating Rules
- This connector is read-only by design:
auth,products, andsalesonly retrieve data. There are no write commands. - Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the token value.
- Buyer emails from
salesmay be hashed or redacted by Gumroad for privacy; do not treat them as complete contact details.
Files
- SKILL.md
- bin/gumroad.py
Maturity
🧪 Draft: written from Gumroad's public API docs; not yet live-tested end-to-end.


