X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Paypal MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Paypal account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Paypal with

ChatGPT WorkClaude CoworkCodexCursor

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Paypal with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Paypal

Ask your agent to connect to Paypal, or simply request any Paypal-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Paypal connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Paypal or request any Paypal-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Paypal MCP server, 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.

Way Forward

With Paypal connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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

ChatGPT Work logo

ChatGPT Work

Use Paypal MCP with ChatGPT Work

Claude Cowork logo

Claude Cowork

Use Paypal MCP with Claude Cowork

Codex logo

Codex

Use Paypal MCP with Codex

Cursor logo

Cursor

Use Paypal MCP with Cursor

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. Hermes 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