SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Razorpay to Claude

Connect Claude Web, Desktop and Cowork to Razorpay MCP. List recent razorpay payment failures, create payment link for invoice, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Razorpay logoRazorpay
Api KeyOauth2

Razorpay is a payment gateway and financial services platform for Indian businesses. It helps companies accept payments, manage refunds, send invoices, and run payouts.

42 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 Razorpay account to Claude via Composio Connect, enabling it to list recent Razorpay payment failures, create payment link for invoice, fetch refund status for customer, 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 Razorpay with

Codex

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

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

For example, ask Claude to:

  • "List recent Razorpay payment failures"
  • "Create payment link for invoice"
  • "Fetch refund status for customer"

It will prompt you to authenticate and authorize access.

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

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

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

Troubleshooting

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

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

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

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

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

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

3. Why does the Razorpay authorization link not work?

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

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

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

The Razorpay connection can expire or lose permission.

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

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

Claude can manage the Razorpay connection for you.

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

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

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

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

Supported Tools

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

Cancel Invoice

Tool to cancel an existing Razorpay invoice.

Cancel Payment Link

Tool to cancel a specific payment link.

Create an Order

Tool to create a Razorpay order with specified amount and currency.

Create Contact

Tool to create a contact for payouts in RazorpayX.

Create Customer

Tool to create a new customer in Razorpay.

Create an Invoice

Tool to create an invoice for billing customers.

Create Item

Tool to create an item that can be used in Razorpay invoices.

Create Payment Link

Tool to create a payment link for collecting payments via a shareable URL.

Delete Invoice

Tool to delete an invoice in Razorpay.

Delete item

Tool to delete an existing item from Razorpay.

Fetch All Customers

Tool to retrieve a paginated list of all customers from Razorpay.

Fetch All Invoices

Tool to fetch all invoices with pagination and filtering support.

Fetch All Payment Links

Tool to fetch all payment links with pagination and filtering support.

Fetch All Payments

Tool to retrieve all payments from your Razorpay account with pagination and time filtering support.

Fetch all refunds for a payment

Tool to retrieve all refunds for a specific payment using the Razorpay API.

Fetch a Payment Link

Tool to retrieve details of a specific payment link by its ID.

Fetch Invoice by ID

Tool to fetch a specific invoice by its ID from Razorpay.

Fetch All Orders

Tool to retrieve a paginated list of all orders from Razorpay.

Fetch Order by ID

Tool to fetch details of a specific Razorpay order using its order ID.

Fetch payments by order

Tool to fetch all payments made for a particular order.

Fetch All Refunds

Tool to retrieve all refunds created by you using the Razorpay API.

Get Contact

Tool to retrieve details of a specific contact by ID in RazorpayX.

Retrieve Customer

Tool to retrieve details of a specific customer by their ID.

Get Fund Account

Tool to retrieve details of a specific fund account by its ID.

Get Item

Tool to retrieve complete details of a specific Razorpay item by its ID.

Get Settlement Reconciliation Report

Tool to fetch settlement reconciliation report for a specific date or month from Razorpay.

Get Transfer Reversals

Tool to fetch all reversals for a specific transfer using the Razorpay Route API.

Issue an Invoice

Tool to issue a draft Razorpay invoice to send it to the customer.

List Customer Tokens

Tool to retrieve all tokens (saved payment methods) for a customer.

List Disputes

Tool to retrieve a list of all disputes with pagination support.

List Fund Accounts

Tool to retrieve a list of all fund accounts from RazorpayX with pagination support.

List Fund Validations

Tool to fetch all fund account validation transactions from RazorpayX with pagination support.

List Items

Tool to retrieve a list of all items from Razorpay with pagination support.

List Payment Downtimes

Tool to fetch all active payment method downtimes from Razorpay.

Notify Payment Link

Tool to send or resend notification for a payment link via SMS or email.

Send/Resend Invoice Notification

Tool to send or resend an invoice notification via email or SMS.

Update Contact

Tool to update an existing contact's details in RazorpayX.

Update Customer

Tool to update an existing customer's details in Razorpay.

Update Invoice

Tool to update an existing draft invoice in Razorpay.

Update Item

Tool to update an existing item's details in Razorpay.

Update Order

Tool to update an existing order in Razorpay.

Update payment link

Tool to update an existing payment link in Razorpay.

FRAMEWORKS

How to build Razorpay MCP Agent with another framework

Codex logo

Codex

Use Razorpay MCP with Codex

FAQ

Frequently asked questions

With a standalone Razorpay MCP server, the agents and LLMs can only access a fixed set of Razorpay tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Razorpay 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 Razorpay tools.

Yes, absolutely. You can configure which Razorpay 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 Razorpay data and credentials are handled as safely as possible.

Start with Razorpay.It takes 30 seconds.

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

Start building