Stripe
Connect your Stripe account to query billing data, customer information, and subscription status through Sasha.
What you can do
- Query customers: find customer records and details
- Check subscriptions: status, plans, billing cycles
- Review invoices: payment history and upcoming charges
- Analyse revenue: MRR, churn, growth metrics
- Track payments: transaction status and disputes
Prerequisites
- Stripe account with API access
- Restricted API key with read permissions
- Appropriate Stripe role (at minimum, Analyst)
Create a restricted API key
- Go to Stripe Dashboard → Developers → API keys
- Click Create restricted key
- Name it (e.g., "Sasha Read-Only")
- Enable read access for:
- Customers
- Subscriptions
- Invoices
- Charges
- Balance
- Click Create key and copy it
Setup
- Navigate to Settings → Tools → Stripe Billing Workspace
- Paste your restricted API key
- Click Save Configuration
- Click Register Server to enable Claude access
- Click Run Smoke Test to check the connection
Two or more Stripe accounts
A business can take card payments in more than one Stripe account, for example one for each product. Add one connection for each account.
- In each Stripe account, make a restricted key. For a Finance Agent report, give read access to Balance, Charges, PaymentIntents, Invoices, Subscriptions, Prices and Products, and None for Customers and everything else.
- In Sasha, open Settings → Tools → Stripe Billing Workspace and click Add a Stripe account. You can also open MCP Servers → Add MCP Server → Use a key → A Stripe account.
- Type the Account label, for example
training. Sasha names the connectionstripe-training. - Paste the key in Restricted key and click Add Server. Sasha refuses a secret key (
sk_), because a secret key can change data. - Under Stripe accounts on the card, click Test next to the new connection.
The card lists every Stripe connection, each with Test and Remove. The connection that you set up with the steps above stays one of them. Paste each key only in the connection form, never in a chat.
For a Finance Agent, add a row for each Stripe account in Accounts in the Finance Brief, with its product and its connection. Its card payments and card fees then go to that product. If one account is not read, the report still goes out, marked not complete, with a step to connect it. See Add a Finance Agent or a Marketing Agent.
Example uses
"How many active subscribers do we have?"
"Show me customers with failed payments this month"
"What's our MRR growth over the last 6 months?"
"Find the subscription details for customer@example.com"
"List invoices over $1,000 from this quarter"
"Which subscription plans are most popular?"
Available data
| Category | Examples |
|---|---|
| Customers | Email, name, metadata, created date |
| Subscriptions | Status, plan, billing cycle, next invoice |
| Invoices | Amount, status, line items, payment method |
| Charges | Amount, status, refunds, disputes |
| Balance | Available, pending, currency breakdown |
Security notes
- Use restricted keys with minimal permissions
- API key is encrypted at rest
- Read-only access recommended
- Revoke the key in Stripe to disconnect
Troubleshooting
| Issue | Solution |
|---|---|
| "Invalid API key" | Verify the key in Stripe Dashboard |
| "Permission denied" | Check restricted key permissions |
| "Rate limited" | Wait a moment, Stripe limits API calls |