How to connect Polar to Claude

Connect Claude Web, Desktop and Cowork to Polar MCP. List all products in your polar account, review active polar subscriptions this month, and more using natural language, with authentication handled for you.

Polar logoPolar
Oauth2Api KeyBearer TokenNo Auth

Polar is a merchant-of-record platform for digital products, payments, subscriptions, and customer management. It simplifies global selling by handling checkout, billing, taxes, and customer portals.

134 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Polar account to Claude via Composio Connect, enabling it to list all products in your Polar account, review active Polar subscriptions this month, show recent Polar orders and customer details, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Polar with

Connecting Polar to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Polar account

Back in Claude, ask it to connect to Polar or give it any Polar-related task.

For example, ask Claude to:

  • "List all products in your Polar account"
  • "Review active Polar subscriptions this month"
  • "Show recent Polar orders and customer details"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Polar account is ready to use.

What is the Polar Claude Connector, and what's possible with it?

The Polar MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Polar account. It provides structured and secure access to Polar's merchant-of-record tools, so your agent can create products and checkout sessions, manage customers and subscriptions, issue refunds, and handle customer portal and licensing tasks on your behalf.

  • Products and checkout management: Have your agent create products, checkout sessions, checkout links, discounts, and customer orders for your Polar storefront.
  • Customer and subscription operations: Let the agent create customers, add customer members, create subscriptions, cancel portal subscriptions, and manage customer payment methods.
  • Benefits and license keys: Direct your agent to create benefits such as license keys or file downloads, activate or deactivate license key instances, and manage customer seats.
  • Payments, refunds, and disputes: Instruct your agent to create refunds, accept disputes, retry customer payments, or create orders for off-session charges against saved payment methods.
  • Account configuration and reporting: Have your agent create organizations, custom fields, files, meters, metric dashboards, and webhook endpoints for your Polar operations.

Troubleshooting

1. Why does Claude not use the Composio connector for Polar?

The connector can show as connected, but Claude must use it in each Polar conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Polar again.

2. Why does Claude show an MCP server error before Polar connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Polar.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Polar.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Polar authorization link not work?

The Composio connector is one server. Your Polar account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Polar connection.
  • Composio creates a fresh Polar authorization link.
  • Open that link in your browser and finish the Polar sign-in.

4. Why do Polar actions fail after they worked before?

The Polar connection can expire or lose permission.

  • Ask Claude to inspect the Polar connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Polar account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Polar.
  • If the action still fails with a permission error, check that the connected account has that permission in Polar itself.

5. How do I switch to a different Polar account?

Claude can manage the Polar connection for you.

  • Ask Claude to disconnect or delete the current Polar account.
  • Ask Claude to connect Polar again.
  • Open the new Composio authorization link for Polar.
  • Sign in with the other Polar account in the browser.
  • After the account connects, ask Claude to retry the Polar task.

6. Why is my Polar connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Polar connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Polar tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Polar.
TOOLS

Supported Tools

Every Polar action and event your agent gets out of the box.

Accept Dispute

Accept a dispute, permanently conceding the chargeback and settling it as lost.

Activate License Key

Activate a license key instance.

Activate License Key

Activate a license key instance.

Assign Seat

Assign a customer seat.

Complete File Upload

Complete a file upload.

Confirm Checkout Session from Client

Confirm a checkout session by client secret.

Create Benefit

Create a benefit, for example license keys, file downloads or Discord access.

Create Checkout Session

Create a checkout session.

Create Checkout Link

Create a checkout link.

Create Customer

Create a customer.

Create Customer Member

Add a member to a customer by UUID.

Create Customer Member by External ID

Add a member to a uniquely identified external customer.

Create Custom Field

Create an organization custom field for collecting structured customer or checkout data.

Create Discount

Create a discount.

Create File

Create a Polar file record and obtain multipart upload details.

Create Meter

Create a meter.

Create Metric Dashboard

Create a user-defined metric dashboard.

Create Order

Create a draft order for an off-session charge against a saved payment Organization Access Token permissions: `orders:write`.

Create Organization

Create an organization using OAuth2 with the organizations:write scope.

Create Product

Create a product.

Create Refund

Create a refund.

Create Subscription

Create a subscription for an existing customer to a free recurring product, identified by Polar customer ID or external customer ID.

Create Webhook Endpoint

Create a webhook endpoint.

Deactivate License Key

Deactivate a license key instance.

Deactivate License Key

Deactivate a license key instance.

Delete Benefit

Delete a benefit.

Delete Checkout Link

Delete a checkout link.

Delete Customer

Delete a customer.

Delete Customer by External ID

Delete a customer by external ID.

Delete Customer Member

Permanently remove a member by customer UUID and member UUID.

Delete Customer Member by External ID

Permanently remove a member by customer and member external IDs.

Delete Custom Field

Permanently delete a custom field by ID.

Delete Discount

Delete a discount.

Delete File

Delete a file.

Delete Metric Dashboard

Delete a user-defined metric dashboard.

Delete Product

Delete a product.

Delete Webhook Endpoint

Delete a webhook endpoint.

Export Customers

Export customers as a CSV file.

Export Metrics

Export metrics as a CSV file.

Export Orders

Export orders as a CSV file.

Export Subscriptions

Export subscriptions as a CSV file.

Finalize Order

Finalize a draft order and synchronously attempt an off-session charge.

Generate Order Invoice

Trigger generation of an order's invoice.

Get Benefit

Get a benefit by ID.

Get Checkout Session

Get a checkout session by ID.

Get Checkout Session from Client

Get a checkout session by client secret.

Get Checkout Link

Get a checkout link by ID.

Get Customer

Get a customer by ID.

Get Customer by External ID

Get a customer by external ID.

Get Customer Member

Get a member by customer UUID and member UUID without changing membership.

Get Customer Member by External ID

Get a member by customer and member external IDs without changing membership.

Get Customer Meter

Get a customer meter by ID.

Get Customer State

Get a customer state by ID.

Get Customer State by External ID

Get a customer state by external ID.

Get Custom Field

Get one organization custom field and its validation settings by ID.

Get Discount

Get a discount by ID.

Get Dispute

Get a payment dispute by ID.

Get Event

Get an event by ID.

Get License Key

Get a license key.

Get Activation

Get a license key activation.

Get Meter

Get a meter by ID.

Get Meter Quantities

Get quantities of a meter over a time period.

Get Metric Dashboard

Get a user-defined metric dashboard by ID.

Get Metrics

Get metrics about your orders and subscriptions.

Get Metrics Limits

Get the interval limits for the metrics endpoint.

Get Order

Get an order by ID.

Get Order Invoice

Get an order's invoice data.

Get Order Receipt

Get an order's presigned receipt PDF URL, which is null while the receipt is being generated.

Get Organization

Get an organization by ID.

Get Payment

Get a payment by ID.

Get Organization

Get a customer portal's organization by slug.

Get Product

Get a product by ID.

Get Subscription

Get a subscription by ID.

Get Webhook Endpoint

Get a webhook endpoint by ID.

Ingest Events

Ingest batch of events.

List Benefit Files

List the downloadable files for a benefit with their download statistics.

List Benefit Grants

List benefit grants across all benefits accessible to the authenticated subject.

List Benefit Grants

List the individual grants for a benefit.

List Benefits

List benefits.

List Checkout Links

List checkout links.

List Checkout Sessions

List checkout sessions.

List Customer Members

List members of a customer by UUID without changing membership.

List Customer Members by External ID

List members of a uniquely identified external customer without changing membership.

List Customer Meters

List customer meters.

List Customer Payment Methods

Get saved payment methods of a customer.

List Customer Payment Methods by External ID

Get saved payment methods of a customer by external ID.

List Customers

List customers.

List Seats

List customer seats for a subscription or order, including invitation and claim state.

List Custom Fields

List custom data fields configured for an organization and their validation settings.

List Discounts

List discounts.

List Disputes

List payment disputes.

List Event Names

List event names.

List Events

List events.

List Event Types

List event types with usage statistics.

List Files

List files.

List License Keys

Get license keys connected to the given organization & filters.

List Meters

List meters.

List Metric Dashboards

List user-defined metric dashboards.

List Orders

List orders.

List Organizations

List organizations.

List Payments

List payments.

List Products

List products.

List Refunds

List refunds.

List Subscriptions

List subscriptions.

List Webhook Deliveries

List webhook deliveries.

List Webhook Endpoints

List webhook endpoints with pagination; Organization Access Token permissions are `webhooks:read` or `webhooks:write`.

Redeliver Webhook Event

Schedule the re-delivery of a webhook event.

Resend Invitation

Resend the invitation email for an unclaimed customer seat.

Revoke Seat

Permanently revoke a customer seat by ID.

Revoke Subscription

Revoke a subscription, i.e cancel immediately.

Rotate License Key

Rotate a license key.

Update Benefit

Update a benefit.

Update Checkout Session

Update a checkout session.

Update Checkout Session from Client

Update a checkout session by client secret.

Update Checkout Link

Update a checkout link.

Update Customer

Update a customer.

Update Customer by External ID

Update a customer by external ID.

Update Customer Member

Update a member by customer UUID and member UUID.

Update Customer Member by External ID

Update a member by customer and member external IDs.

Update Custom Field

Update an organization custom field's label, validation, or data-collection settings.

Update Discount

Update a discount.

Update Event Type

Update an event type's label and optionally its dynamic label selector.

Update File

Update a file's name or version.

Update License Key

Update a license key.

Update Meter

Update a meter.

Update Metric Dashboard

Update a user-defined metric dashboard.

Update Order

Update an order's billing name or billing address; country and state cannot be updated.

Update Organization

Update an organization.

Update Product

Update a product.

Update Product Benefits

Update benefits granted by a product.

Update Subscription

Update a subscription.

Update Webhook Endpoint

Update a webhook endpoint.

Validate License Key

Validate a license key and optionally increment its usage count.

Validate License Key

Validate a license key and optionally increment its usage count.

FAQ

Frequently asked questions

Start with Polar.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Polar tool your agent needs.Free to start.

Start building