stripe-automation — Claude Code skill: what it does, how to install
stripe-automation handles Stripe customers, invoices, subscriptions, and refunds through Rube MCP directly in your coding agent.
MIT 120 installs ★ 3,785 updated 2026-10-25
npx skills add davepoon/buildwithclaude --skill stripe-automation -a claude-codeWhat stripe-automation does
This skill coordinates Composio's Stripe toolkit operations via Rube MCP. It lets the agent search customer profiles, register payment intents, set up recurring subscriptions, draft invoices, and process refunds. The workflow always queries RUBE_SEARCH_TOOLS first to fetch fresh endpoint schemas.
Money values must be provided in the lowest currency denominator, such as cents for USD and EUR, while zero-decimal currencies like JPY take raw integers. Currency identifiers must remain strictly lowercase. Subscriptions require valid customer records with attached payment methods, referencing price_ IDs rather than prod_ objects.
Operations will fail completely unless the https://rube.app/mcp server is configured and the stripe toolkit connection status reads ACTIVE.
What it helps with
- issue partial or complete refunds on existing charges
- prevent duplicate customer records by searching email addresses first
- create recurring billing subscriptions using specific price IDs
- draft custom invoices with disabled automatic finalization
Example prompts for the agent
- Check Stripe for a customer with email [email protected] and list their charges
- Create a payment intent for 4900 cents in usd currency
- Issue a refund for charge ch_example with reason requested_by_customer
How to install stripe-automation
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill stripe-automation -a claude-code2Manually: put the files in place
~/.claude/skills/stripe-automation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/stripe-automation/
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill stripe-automation -a codex2Manually: put the files in place
.agents/skills/stripe-automation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill stripe-automation -a cursor2Manually: put the files in place
.cursor/skills/stripe-automation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/stripe-automation2Manually: put the files in place
.github/skills/stripe-automation/SKILL.md1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill stripe-automation -a gemini-cli2Platform CLI
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/stripe-automationManually: put the files in place
.devin/skills/stripe-automation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill stripe-automation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about stripe-automation
How to install stripe-automation in Claude Code?
Run npx skills add davepoon/buildwithclaude --skill stripe-automation -a claude-code in your terminal.
What does stripe-automation do?
It orchestrates Stripe payment workflows, customer lookups, subscriptions, invoices, and chargebacks via Composio tooling on Rube MCP.
What prerequisites are required before executing Stripe tasks?
Add https://rube.app/mcp as an MCP server endpoint and verify that the stripe toolkit shows an ACTIVE state inside RUBE_MANAGE_CONNECTIONS.
Source text
SKILL.md · MIT
---
name: stripe-automation
description: "Automate Stripe tasks via Rube MCP (Composio): customers, charges, subscriptions, invoices, products, refunds. Always search tools first for current schemas."
requires:
mcp: [rube]
category: ecommerce
---
# Stripe Automation via Rube MCP
Automate Stripe payment operations through Composio's Stripe toolkit via Rube MCP.
**Toolkit docs**: [composio.dev/toolkits/stripe](https://composio.dev/toolkits/stripe)
## Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Stripe connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `stripe`
- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas
## Setup
**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds
2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `stripe`
3. If connection is not ACTIVE, follow the returned auth link to complete Stripe connection
4. Confirm connection status shows ACTIVE before running any workflows
## Core Workflows
### 1. Manage Customers
**When to use**: User wants to create, update, search, or list Stripe customers
**Tool sequence**:
1. `STRIPE_SEARCH_CUSTOMERS` - Search customers by email/name [Optional]
2. `STRIPE_LIST_CUSTOMERS` - List all customers [Optional]
3. `STRIPE_CREATE_CUSTOMER` - Create a new customer [Optional]
4. `STRIPE_POST_CUSTOMERS_CUSTOMER` - Update a customer [Optional]
**Key parameters**:
- `email`: Customer email
- `name`: Customer name
- `description`: Customer description
- `metadata`: Key-value metadata pairs
- `customer`: Customer ID for updates (e.g., 'cus_xxx')
**Pitfalls**:
- Stripe allows duplicate customers with the same email; search first to avoid duplicates
- Customer IDs start with 'cus_'
### 2. Manage Charges and Payments
**When to use**: User wants to create charges, payment intents, or view charge history
**Tool sequence**:
1. `STRIPE_LIST_CHARGES` - List charges with filters [Optional]
2. `STRIPE_CREATE_PAYMENT_INTENT` - Create a payment intent [Optional]
3. `STRIPE_CONFIRM_PAYMENT_INTENT` - Confirm a payment intent [Optional]
4. `STRIPE_POST_CHARGES` - Create a direct charge [Optional]
5. `STRIPE_CAPTURE_CHARGE` - Capture an authorized charge [Optional]
**Key parameters**:
- `amount`: Amount in smallest currency unit (e.g., cents for USD)
- `currency`: Three-letter ISO currency code (e.g., 'usd')
- `customer`: Customer ID
- `payment_method`: Payment method ID
- `description`: Charge description
**Pitfalls**:
- Amounts are in smallest currency unit (100 = $1.00 for USD)
- Currency codes must be lowercase (e.g., 'usd' not 'USD')
- Payment intents are the recommended flow over direct charges
### 3. Manage Subscriptions
**When to use**: User wants to create, list, update, or cancel subscriptions
**Tool sequence**:
1. `STRIPE_LIST_SUBSCRIPTIONS` - List subscriptions [Optional]
2. `STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS` - Create subscription [Optional]
3. `STRIPE_RETRIEVE_SUBSCRIPTION` - Get subscription details [Optional]
4. `STRIPE_UPDATE_SUBSCRIPTION` - Modify subscription [Optional]
**Key parameters**:
- `customer`: Customer ID
- `items`: Array of price items (price_id and quantity)
- `subscription`: Subscription ID for retrieval/update (e.g., 'sub_xxx')
**Pitfalls**:
- Subscriptions require a valid customer with a payment method
- Price IDs (not product IDs) are used for subscription items
- Cancellation can be immediate or at period end
### 4. Manage Invoices
**When to use**: User wants to create, list, or search invoices
**Tool sequence**:
1. `STRIPE_LIST_INVOICES` - List invoices [Optional]
2. `STRIPE_SEARCH_INVOICES` - Search invoices [Optional]
3. `STRIPE_CREATE_INVOICE` - Create an invoice [Optional]
**Key parameters**:
- `customer`: Customer ID for invoice
- `collection_method`: 'charge_automatically' or 'send_invoice'
- `days_until_due`: Days until invoice is due
**Pitfalls**:
- Invoices auto-finalize by default; use `auto_advance: false` for draft invoices
### 5. Manage Products and Prices
**When to use**: User wants to list or search products and their pricing
**Tool sequence**:
1. `STRIPE_LIST_PRODUCTS` - List products [Optional]
2. `STRIPE_SEARCH_PRODUCTS` - Search products [Optional]
3. `STRIPE_LIST_PRICES` - List prices [Optional]
4. `STRIPE_GET_PRICES_SEARCH` - Search prices [Optional]
**Key parameters**:
- `active`: Filter by active/inactive status
- `query`: Search query for search endpoints
**Pitfalls**:
- Products and prices are separate objects; a product can have multiple prices
- Price IDs (e.g., 'price_xxx') are used for subscriptions and checkout
### 6. Handle Refunds
**When to use**: User wants to issue refunds on charges
**Tool sequence**:
1. `STRIPE_LIST_REFUNDS` - List refunds [Optional]
2. `STRIPE_POST_CHARGES_CHARGE_REFUNDS` - Create a refund [Optional]
3. `STRIPE_CREATE_REFUND` - Create refund via payment intent [Optional]
**Key parameters**:
- `charge`: Charge ID for refund
- `amount`: Partial refund amount (omit for full refund)
- `reason`: Refund reason ('duplicate', 'fraudulent', 'requested_by_customer')
**Pitfalls**:
- Refunds can take 5-10 business days to appear on customer statements
- Amount is in smallest currency unit
## Common Patterns
### Amount Formatting
Stripe uses smallest currency unit:
- USD: $10.50 = 1050 cents
- EUR: 10.50 = 1050 cents
- JPY: 1000 = 1000 (no decimals)
### Pagination
- Use `limit` parameter (max 100)
- Check `has_more` in response
- Pass `starting_after` with last object ID for next page
- Continue until `has_more` is false
## Known Pitfalls
**Amount Units**:
- Always use smallest currency unit (cents for USD/EUR)
- Zero-decimal currencies (JPY, KRW) use the amount directly
**ID Prefixes**:
- Customers: `cus_`, Charges: `ch_`, Subscriptions: `sub_`
- Invoices: `in_`, Products: `prod_`, Prices: `price_`
- Payment Intents: `pi_`, Refunds: `re_`
## Quick Reference
| Task | Tool Slug | Key Params |
|------|-----------|------------|
| Create customer | STRIPE_CREATE_CUSTOMER | email, name |
| Search customers | STRIPE_SEARCH_CUSTOMERS | query |
| Update customer | STRIPE_POST_CUSTOMERS_CUSTOMER | customer, fields |
| List charges | STRIPE_LIST_CHARGES | customer, limit |
| Create payment intent | STRIPE_CREATE_PAYMENT_INTENT | amount, currency |
| Confirm payment | STRIPE_CONFIRM_PAYMENT_INTENT | payment_intent |
| List subscriptions | STRIPE_LIST_SUBSCRIPTIONS | customer |
| Create subscription | STRIPE_POST_CUSTOMERS_CUSTOMER_SUBSCRIPTIONS | customer, items |
| Update subscription | STRIPE_UPDATE_SUBSCRIPTION | subscription, fields |
| List invoices | STRIPE_LIST_INVOICES | customer |
| Create invoice | STRIPE_CREATE_INVOICE | customer |
| Search invoices | STRIPE_SEARCH_INVOICES | query |
| List products | STRIPE_LIST_PRODUCTS | active |
| Search products | STRIPE_SEARCH_PRODUCTS | query |
| List prices | STRIPE_LIST_PRICES | product |
| Search prices | STRIPE_GET_PRICES_SEARCH | query |
| List refunds | STRIPE_LIST_REFUNDS | charge |
| Create refund | STRIPE_CREATE_REFUND | charge, amount |
| Payment methods | STRIPE_LIST_CUSTOMER_PAYMENT_METHODS | customer |
| Checkout session | STRIPE_CREATE_CHECKOUT_SESSION | line_items |
| List payment intents | STRIPE_LIST_PAYMENT_INTENTS | customer |
---
*Powered by [Composio](https://composio.dev)*
© davepoon · MIT · davepoon/buildwithclaude