X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Recurly to Claude

Connect Claude Web, Desktop and Cowork to Recurly MCP. List active subscriptions expiring this month, create a refund for invoice 12345, and more using natural language, with authentication handled for you.

Create my free accountGet a demo
Recurly logoRecurly
Api Key

Recurly is a subscription management and recurring billing platform for managing customers, plans, subscriptions, invoices, and payments. It helps businesses automate billing, revenue operations, and subscription lifecycle management.

10 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 Recurly account to Claude via Composio Connect, enabling it to list active subscriptions expiring this month, create a refund for invoice 12345, update plan pricing for enterprise plan, 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.

Also integrate Recurly with

ChatGPTHermes

Connecting Recurly 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 Recurly account

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

For example, ask Claude to:

  • "List active subscriptions expiring this month"
  • "Create a refund for invoice 12345"
  • "Update plan pricing for enterprise plan"

It will prompt you to authenticate and authorize access.

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

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

The Recurly MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Recurly account. It provides structured and secure access so your agent can perform Recurly operations on your behalf.

Troubleshooting

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

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

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

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

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

  • 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 Recurly.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Recurly authorization link not work?

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

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

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

The Recurly connection can expire or lose permission.

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

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

Claude can manage the Recurly connection for you.

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

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

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

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Recurly 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 Recurly.
TOOLS

Supported Tools

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

Get Account

Fetch one Recurly customer account by opaque ID or account code.

Get Item

Fetch one Recurly catalog item by opaque ID or item code.

Get Plan

Fetch one Recurly subscription plan by opaque ID or plan code.

List Accounts

Find customer accounts on the Recurly site by email or subscription and past-due status.

List Invoices

List invoices by state or invoice type to inspect billed amounts, balances, and account or subscription references without changing invoice state.

List Items

List reusable catalog items on the connected Recurly site, including codes, state, tax settings, and currency pricing.

List Plans

List subscription plans and their pricing configuration on the connected Recurly site.

List Sites

List Recurly sites visible to the connected private API key, including each site's ID, subdomain, mode, currencies, and enabled features.

List Subscriptions

List subscriptions and filter by lifecycle state without creating, changing, pausing, canceling, or billing a subscription.

List Transactions

List payment transactions by type and success status for read-only payment investigation.

FRAMEWORKS

How to build Recurly MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Recurly MCP with ChatGPT

Hermes logo

Hermes

Use Recurly MCP with Hermes

FAQ

Frequently asked questions

With a standalone Recurly MCP server, the agents and LLMs can only access a fixed set of Recurly tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Recurly and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Recurly tools.

Yes, absolutely. You can configure which Recurly scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Recurly data and credentials are handled as safely as possible.

Start with Recurly.It takes 30 seconds.

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

Start building