SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Paypal to Claude

Connect Claude Web, Desktop and Cowork to Paypal MCP. Create paypal invoice for consulting work, list recent paypal payments this week, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Paypal logoPaypal
S2s Oauth2

PayPal is an online payment platform for sending, receiving, and managing money. It helps businesses accept payments, handle invoices, and process transactions globally.

78 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 Paypal account to Claude via Composio Connect, enabling it to create PayPal invoice for consulting work, list recent PayPal payments this week, issue refund for duplicate PayPal charge, 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 Paypal with

CursorChatGPTGrok BotCodexHermesAtomic Agent

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

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

For example, ask Claude to:

  • "Create PayPal invoice for consulting work"
  • "List recent PayPal payments this week"
  • "Issue refund for duplicate PayPal charge"

It will prompt you to authenticate and authorize access.

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

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

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

Troubleshooting

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

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

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

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

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

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

3. Why does the Paypal authorization link not work?

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

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

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

The Paypal connection can expire or lose permission.

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

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

Claude can manage the Paypal connection for you.

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

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

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

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

Supported Tools

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

Activate billing plan

Activates a billing plan in PayPal, making it available for subscription signups.

Add Batch Tracking Information

Add tracking information for multiple PayPal transactions in a single request.

Authorize order payment

Authorizes payment for an order.

Cancel Invoice

Cancels a sent PayPal invoice and optionally notifies relevant parties.

Cancel Invoice Reminders

Cancels the automatic payment reminders for a PayPal invoice.

Capture subscription payment

Captures an authorized payment on a PayPal subscription.

Charge Payment Method

Charges a payment method and captures funds immediately using Braintree GraphQL API.

Create invoice

Creates a PayPal draft invoice.

Create PayPal payment

Creates a PayPal payment using the v1 Payments API.

Create billing plan (legacy)

Creates a PayPal billing plan using the legacy payments API (POST /v1/payments/billing-plans).

Create a billing plan

Creates a PayPal billing plan for subscription billing.

Create Product

Creates a new product in PayPal's catalog.

Create Subscription

Creates a new PayPal subscription based on a billing plan.

Create template

Creates a PayPal invoice template.

Create a webhook

Creates a PayPal webhook endpoint to receive notifications about events.

Create a webhook lookup

Creates a new PayPal webhook lookup to verify a webhook signature.

Create a web experience profile

Creates a PayPal web experience profile for customizing checkout.

Deactivate Plan

Deactivates a PayPal billing plan, making it unavailable for new subscriptions while preserving existing subscriptions.

Delete Invoice External Payment

Permanently deletes an external payment from a specified PayPal invoice.

Delete Invoice

Deletes a PayPal invoice by its ID.

Delete invoice payment record

Deletes a payment record from a PayPal invoice.

Delete Invoice Refund Record

Permanently deletes a refund record from a specified PayPal invoice.

Delete Payment Resource

Deletes a PayPal payment resource.

Delete Template

Deletes a PayPal invoice template by its ID.

Delete Webhook

Deletes a PayPal webhook by its ID.

Delete Web Experience Profile

Deletes a PayPal web experience profile by its ID.

Fetch Braintree Node

Fetches any object that extends the Node interface using its ID.

Finalize Braintree Dispute

Finalizes a Braintree dispute after adding evidence, submitting it to the cardholder's bank for review.

Find eligible PayPal payment methods

Find a list of eligible payment methods for a customer.

Generate PayPal Client Token

Generate a client token for PayPal JavaScript SDK integration.

Generate Next Invoice Number

Generates the next invoice number from PayPal's invoicing service.

Generate Next Invoice Number (v2)

Generates the next invoice number from PayPal's invoicing service using the v2 API.

Generate Invoice QR Code

Generates a QR code image for a PayPal invoice using the v2 invoicing API.

List Billing Subscriptions

Lists PayPal billing subscriptions for the merchant account.

Get Invoice

Retrieves detailed information about a specific PayPal invoice by its ID.

Get Invoice QR Code

Generates a QR code image for a PayPal invoice.

Get Invoice Template

Retrieves detailed information about a specific PayPal invoice template by its ID.

Get Order Details

Retrieves detailed information about a specific PayPal order by its ID.

Get Payment Details

Retrieves details for a PayPal payment by its ID using the deprecated v1 Payments API.

Get Refund Details

Retrieves details for a PayPal refund by its ID.

Get Plan

Retrieves details for a specific PayPal billing plan by its ID.

Get Product

Retrieves detailed information about a specific PayPal product by its ID.

Get Subscription Details

Retrieves the details of a PayPal subscription by its ID.

Get PayPal User Info

Retrieves user claims from PayPal using OpenID Connect.

Get User Info

Retrieves user profile information from PayPal.

Get Webhook

Retrieves detailed information about a specific PayPal webhook by its ID.

Get Webhook Lookup

Retrieves detailed information about a specific PayPal webhook lookup by its ID.

Get Web Profile

Retrieves detailed information about a PayPal web experience profile by its ID.

List PayPal Disputes

List PayPal customer disputes with optional filtering by date, transaction, or state.

List PayPal Invoices

List invoices from PayPal with pagination support.

List Legacy Billing Plans

Lists billing plans using the legacy PayPal payments API (v1/payments/billing-plans).

List Payments

Lists payment information for authorized payments.

List billing plans

Lists billing plans from PayPal with optional filtering and pagination.

List PayPal Products

List products from the PayPal product catalog.

List PayPal Invoice Templates

List invoice templates from PayPal.

List webhook event types

Lists all available PayPal webhook event types to which you can subscribe.

List webhook event type subscriptions

Lists event type subscriptions for a specific PayPal webhook.

List webhook lookups

Lists all webhook lookups associated with your PayPal application.

List Webhooks

Lists webhooks configured for an application or PayPal account.

List web experience profiles

Lists web experience profiles from PayPal with optional pagination.

Update checkout order (partial)

Partially updates a PayPal checkout order using JSON Patch (RFC 6902) operations.

Update billing plan (partial)

Partially updates a PayPal billing plan using JSON Patch (RFC 6902) operations.

Update Subscription

Update a PayPal subscription using JSON Patch operations.

Update web experience profile (partial)

Partially updates a PayPal web experience profile using JSON Patch (RFC 6902) operations.

Braintree Ping

Sends a ping query to the PayPal Braintree GraphQL API.

Query Braintree Report

Queries Braintree reports via GraphQL API.

Retrieve Payment Resource

Retrieve a PayPal payment resource by its ID.

Search PayPal Invoices

Search for PayPal invoices based on various filter criteria.

Send Invoice

Sends a PayPal invoice to the recipient via email.

Simulate Webhook Event

Simulates a webhook event to test your webhook integration.

Update Dispute

Partially update a PayPal dispute using JSON Patch operations.

Update Invoice (Full)

Fully updates a PayPal invoice by replacing the entire invoice with the provided data.

Update product (partial)

Partially updates a PayPal product using JSON Patch (RFC 6902) operations.

Update Webhook

Updates a PayPal webhook using JSON Patch (RFC 6902) operations.

Update template

Fully updates a PayPal invoice template.

Update web experience profile

Updates a PayPal web experience profile.

Verify Payment Method via Braintree

Verifies a multi-use payment method to ensure it has passed fraud rules and is associated with a valid account.

Verify Webhook Signature

Verifies the signature of a PayPal webhook notification to confirm its authenticity.

FRAMEWORKS

How to build Paypal MCP Agent with another framework

Cursor logo

Cursor

Use Paypal MCP with Cursor

ChatGPT logo

ChatGPT

Use Paypal MCP with ChatGPT

Grok Bot logo

Grok Bot

Use Paypal MCP with Grok Bot

Codex logo

Codex

Use Paypal MCP with Codex

Hermes logo

Hermes

Use Paypal MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Paypal MCP with Atomic Agent

FAQ

Frequently asked questions

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

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

Start with Paypal.It takes 30 seconds.

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

Start building