Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add davepoon/buildwithclaude --skill stripe-automation -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/stripe-automation/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/stripe-automation/

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

Similar skills

All skills for Finance and business →

From the same set235

The whole set →
posthog-automation posthog-automation — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that drives PostHog through Rube MCP (Composio). Covers event capture, feature flags, projects and user profiles. CX Codex +1 121installs wrike-automation wrike-automation controls Wrike work through Rube MCP: tasks, folders, projects, assignees, and status tracking. Useful when project actions should start in an AI coding client. CX Codex +1 121installs zoho-crm-automation zoho-crm-automation — a skill for automating Zoho CRM operations via Rube MCP: create and update records, search contacts, manage leads, and convert them. Requires active Zoho subscription and Rube MCP connection. CX Codex +1 121installs freshservice-automation freshservice-automation handles Freshservice ITSM workflows through Rube MCP, covering ticket creation, searches, bulk updates, and service requests. CX Codex +1 121installs mixpanel-automation The mixpanel-automation skill automates Mixpanel workflows: aggregate events, segment by properties, build funnels, query user profiles and cohorts. Works through Rube MCP (Composio) — requires an active Mixpanel connection. CX Codex +1 120installs coda-automation coda-automation controls Coda docs, tables, permissions, and exports through Rube MCP directly from your coding agent. CX Codex +1 120installs postmark-automation postmark-automation runs Postmark through Rube MCP: templated sends, template edits, delivery stats and bounce review from the agent chat. CX Codex +1 120installs square-automation square-automation automates Square operations: payments, orders, invoices, and locations via Rube MCP. Use it to search transactions, update order status, and manage invoices from your editor. CX Codex +1 119installs

Project sponsors

Companies that keep this analytics open