---
title: "Stripe Integration"
description: "Manage Stripe customers, payments, and subscriptions"
---
The Stripe integration provides access to manage Stripe customers, payments, and subscriptions through the Integrate MCP server.

## Installation

The Stripe integration is included with the SDK:

```typescript
import { stripeIntegration } from "integrate-sdk/server";
```

## Setup

### 1. Create a Stripe OAuth App

1. Go to [Stripe Connect Settings](https://dashboard.stripe.com/settings/applications)
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

### 2. Configure the Integration on Your Server

Add the Stripe integration to your server configuration. The integration automatically reads `STRIPE_CLIENT_ID` and `STRIPE_CLIENT_SECRET` from your environment variables:

```typescript
import { createMCPServer, stripeIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    stripeIntegration({
    }),
  ],
});
```

You can override the environment variables by passing explicit values:

```typescript
stripeIntegration({
  clientId: process.env.CUSTOM_STRIPE_ID,
  clientSecret: process.env.CUSTOM_STRIPE_SECRET,
});
```

### 3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

```typescript
import { client } from "integrate-sdk";

await client.authorize("stripe");
const result = await client.stripe.listCustomers({});

console.log(result);
```

If you're using a custom client, add the integration to the integrations array:

```typescript
import { createMCPClient, stripeIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [stripeIntegration()],
});
```

## Configuration Options

<AutoTypeTable
  path="../src/integrations/stripe.ts"
  name="StripeIntegrationConfig"
/>


## Tools

### `stripe_list_customers`

List customers

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListCustomersParams"
/>

### `stripe_get_customer`

Get a specific customer

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeGetCustomerParams"
/>

### `stripe_create_customer`

Create a new customer

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCreateCustomerParams"
/>

### `stripe_update_customer`

Update an existing customer

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeUpdateCustomerParams"
/>

### `stripe_delete_customer`

Delete a customer

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeDeleteCustomerParams"
/>

### `stripe_search_customers`

Search customers using Stripe search syntax

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeSearchCustomersParams"
/>

### `stripe_list_payments`

List payment intents

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListPaymentsParams"
/>

### `stripe_get_payment`

Get a specific payment intent

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeGetPaymentParams"
/>

### `stripe_create_payment`

Create a payment intent

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCreatePaymentParams"
/>

### `stripe_cancel_payment`

Cancel a payment intent

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCancelPaymentParams"
/>

### `stripe_capture_payment`

Capture an authorized payment intent

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCapturePaymentParams"
/>

### `stripe_list_subscriptions`

List subscriptions

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListSubscriptionsParams"
/>

### `stripe_get_subscription`

Get a subscription by ID

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeGetSubscriptionParams"
/>

### `stripe_create_subscription`

Create a subscription

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCreateSubscriptionParams"
/>

### `stripe_update_subscription`

Update a subscription

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeUpdateSubscriptionParams"
/>

### `stripe_cancel_subscription`

Cancel a subscription

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCancelSubscriptionParams"
/>

### `stripe_list_invoices`

List invoices

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListInvoicesParams"
/>

### `stripe_get_invoice`

Get an invoice by ID

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeGetInvoiceParams"
/>

### `stripe_create_invoice`

Create an invoice for a customer

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCreateInvoiceParams"
/>

### `stripe_finalize_invoice`

Finalize a draft invoice

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeFinalizeInvoiceParams"
/>

### `stripe_pay_invoice`

Pay an open invoice immediately

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripePayInvoiceParams"
/>

### `stripe_void_invoice`

Void an invoice (cannot be undone)

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeVoidInvoiceParams"
/>

### `stripe_list_products`

List products

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListProductsParams"
/>

### `stripe_get_product`

Get a product by ID

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeGetProductParams"
/>

### `stripe_create_product`

Create a product

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCreateProductParams"
/>

### `stripe_list_prices`

List prices

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListPricesParams"
/>

### `stripe_get_price`

Get a price by ID

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeGetPriceParams"
/>

### `stripe_create_price`

Create a price for a product

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCreatePriceParams"
/>

### `stripe_list_refunds`

List refunds

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListRefundsParams"
/>

### `stripe_get_refund`

Get a refund by ID

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeGetRefundParams"
/>

### `stripe_create_refund`

Create a refund for a payment

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeCreateRefundParams"
/>

### `stripe_get_balance`

Get the current Stripe account balance

_No parameters._

### `stripe_list_events`

List events from the Stripe event log

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListEventsParams"
/>

### `stripe_get_event`

Get a specific event by ID

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeGetEventParams"
/>

### `stripe_list_payment_methods`

List payment methods for a customer

<AutoTypeTable
  path="generated/tool-params/stripe.ts"
  name="StripeListPaymentMethodsParams"
/>

## Notes

- Category: Finance
- Authentication mode: OAuth