Step 1: Add Composio to Claude (one-time process)
- Click the button below. This will take you to the Claude Custom Connector modal.
Add to Claude
- Click Continue
- In the next modal, click Add
- It will take you to the authentication page. Sign in to Composio and approve the connection.
Then return to Claude and make sure Composio is enabled.
Step 2: Connect your first Stripe account
In a new Claude chat, type:
Connect my main Stripe account to Composio. Call it main.
Claude will give you a sign-in link.
- Click the link.
- Sign in to your main Stripe account.
- Review and approve Stripe's permission request.
- Return to Claude.
Claude should confirm that the account is connected.
The name main is how Claude knows which Stripe account to use. Choose short, obvious names. Good examples include:
Step 3: Connect your second Stripe account
In the same Claude chat, type:
Connect another Stripe account. Call it eu-store.
Claude will give you a new sign-in link.
- Open the link.
- Sign in to the second Stripe account.
- Review and approve Stripe's permission request.
- Return to Claude.
Claude should confirm that eu-store is connected.
Important: Check that Stripe is showing the second account before you approve access. If the wrong account appears, sign out or open the link in an incognito or private window.
Repeat this step for every other Stripe account you want to add. Give each connection a short, descriptive name such as main, eu-store, test, or client-acme.
Step 4: Check your connected Stripe accounts
Ask Claude:
List my connected Stripe accounts in Composio. Show each account's name and connection status.
You should see every account you added, and each connection should show as ACTIVE.
For an extra check, ask:
Show the Stripe account ID and business name for each connected account.
This helps you confirm that every label points to the correct Stripe account and that you did not connect the same account twice.
Step 5: Use the right Stripe account
Mention the account name whenever you ask Claude to work with Stripe. This is especially important when an action could change data.
Review failed payments across accounts
Check main and eu-store for failed payments from the last 14 days. Group the results by account and include the customer, amount, currency, and failure reason.
Check unpaid invoices in one account
Using the main account, list unpaid invoices due in the next seven days. Include the customer, amount, and due date.
Compare payment volume
Compare successful payment volume in main and eu-store for the last 30 days. Keep totals separate by account and currency.
Find a customer across accounts
Search all connected Stripe accounts for the customer email customer@example.com. Show which account contains the customer and summarise their latest payment and invoice status.
For actions such as issuing refunds, cancelling subscriptions, or changing customer data, ask Claude to show you the planned action first and wait for your confirmation.