Stripe Integration

Pro v1.0.0

Manage payments, customers, and subscriptions via the Stripe CLI

Requires Claude Code CLI

This skill integrates with Stripe through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Create Payment

Create a payment intent or charge to process a payment

Parameters

Name Type Required Description
amount integer Required Amount in cents (e.g., 5000 for $50.00)
currency string Required Three-letter ISO currency code (e.g., 'usd', 'eur')
payment_method_types string[] Optional Payment method types to accept (e.g., ['card'])

Try saying...

  • "Create a payment for $50 USD"
  • "Charge $100"
  • "Process a payment of 2500 cents in euros"

Create Customer

Add a new customer to your Stripe account

Parameters

Name Type Required Description
email string Optional Customer's email address
name string Optional Customer's full name
description string Optional Arbitrary description

Try saying...

  • "Create a customer with email john@example.com"
  • "Add a new customer named Jane Doe"
  • "Register customer with email and name"

List Customers

Retrieve a list of customers from your account

Parameters

Name Type Required Description
limit integer Optional Maximum number of customers to return

Try saying...

  • "Show me my customers"
  • "List recent customers"
  • "Get all customers"

Retrieve Customer

Get details for a specific customer by ID

Parameters

Name Type Required Description
customer_id string Required The customer ID (starts with 'cus_')

Try saying...

  • "Show customer cus_abc123"
  • "Get details for customer cus_xyz789"
  • "Retrieve customer information"

Create Subscription

Set up a recurring subscription for a customer

Parameters

Name Type Required Description
customer string Required Customer ID (starts with 'cus_')
items[0][price] string Required Price ID for the subscription (starts with 'price_')

Try saying...

  • "Create a subscription for customer cus_abc123"
  • "Start monthly subscription"
  • "Subscribe customer to plan"

Issue Refund

Refund a charge or payment intent (full or partial)

Parameters

Name Type Required Description
charge string Required Charge ID to refund (starts with 'ch_')
amount integer Optional Amount to refund in cents (omit for full refund)

Try saying...

  • "Refund charge ch_abc123"
  • "Issue a refund for payment"
  • "Refund $25 from charge ch_xyz789"

Listen for Webhooks

Forward webhook events to a local endpoint for testing

Parameters

Name Type Required Description
forward-to string Required Local URL to forward events to (e.g., http://localhost:4242/webhook)

Try saying...

  • "Listen for webhooks on localhost:4242"
  • "Forward webhook events to my local server"
  • "Test webhook integration"

Trigger Test Event

Manually trigger a webhook event for testing

Parameters

Name Type Required Description
event_type string Required Event type to trigger (e.g., 'payment_intent.succeeded')

Try saying...

  • "Trigger a payment succeeded event"
  • "Test a charge failed webhook"
  • "Simulate subscription created event"

Stream API Logs

Watch real-time API request logs for debugging

Parameters

Name Type Required Description
filter-http-method string Optional Filter by HTTP method (GET, POST, DELETE)

Try saying...

  • "Show me API logs"
  • "Stream Stripe requests"
  • "Watch API activity"

Generic API Call

Make arbitrary API calls using GET, POST, or DELETE

Parameters

Name Type Required Description
endpoint string Required API endpoint path (e.g., '/v1/balance')
data object Optional Request data for POST requests

Try saying...

  • "Get my account balance"
  • "Make a POST request to create a product"
  • "Retrieve balance information"

Getting Started

CLI Authentication Easy Setup
  1. 1 Install the CLI: brew install stripe/stripe-cli/stripe (macOS) or follow Linux instructions
  2. 2 Run: stripe login
  3. 3 Browser will open - authenticate with your Stripe account
  4. 4 Confirm the pairing code shown in your terminal
  5. 5 CLI stores credentials automatically for future use

Verify Setup

stripe customers list --limit=1

Success: Returns JSON with customer data or empty array

Security & Access

Access Scope

Full access to your Stripe account data and operations, including creating charges, managing customers, issuing refunds, and accessing financial data. Both test and live mode access.

  • The CLI has full access to your Stripe account after authentication
  • Be extremely careful when using the --live flag - it affects real customer data and transactions
  • Always use test mode (default) for development and testing
  • Never commit the ~/.config/stripe/config.toml file to version control
  • API credentials are stored locally and have the same privileges as dashboard access
  • Refunds and charges are irreversible - double-check before executing in live mode

Limitations

  • Requires browser access for initial authentication (stripe login)
  • Some advanced API features may require direct API calls
  • Live mode operations affect real customer data - use with caution

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
CLI
Auth
CLI Authentication
Setup
Easy Setup
Tools Required
Bash
CLI Dependencies
stripe

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements