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.

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.

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

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

Also integrate Paypal with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ 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 to orders, refunds, invoices, subscriptions, and billing plans, so your agent can authorize order payments, send or cancel invoices, create subscriptions, retrieve transaction details, and activate billing plans on your behalf.

  • Order authorization and review: Have your agent authorize payments for orders and retrieve order details when you need to confirm a purchase.
  • Invoice delivery and cancellation: Let the agent send invoices to customers by email or cancel sent invoices and notify the relevant parties.
  • Subscription creation and tracking: Direct your agent to create subscriptions from billing plans and retrieve subscription details for customer support or account reviews.
  • Billing plan activation: Instruct your agent to activate billing plans so they are ready for new subscription signups.
  • Refund detail retrieval: Have your agent retrieve refund details to help you verify and respond to customer payment questions.

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 PayPal billing plan to make 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 approved PayPal order for later capture.

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 outstanding balance on a PayPal subscription.

Charge Payment Method

Charges a payment method using the Braintree GraphQL API, creating a transaction and beginning settlement.

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 PayPal webhook lookup and returns its ID and any available client ID and related links.

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

Deletes an external payment record 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 by invoice and transaction ID.

Delete Invoice Refund Record

Deletes an external refund record from a specified PayPal invoice using the deprecated Invoicing v1 API.

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

Queries a GraphQL node by global ID at the configured PayPal base URL.

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 using PayPal's deprecated Invoicing v1 API, for use before creating an invoice.

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, with pagination and optional time-range and status filters.

Get Invoice

Retrieves a PayPal invoice by ID, including modeled details such as status, amounts, line items, payments, refunds, recipients, and related links.

Get Invoice QR Code

Generates a QR code image for a PayPal invoice.

Get Invoice Template

Retrieves a PayPal invoice template by ID, including modeled name, settings, invoicer information, recipients, items, amounts, configuration, and links.

Get Order Details

Retrieves a PayPal checkout order by ID, including modeled status, intent, purchase units, payer information, and links.

Get Payment Details

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

Get Refund Details

Retrieves a PayPal refund by ID to check its status, amount, and other details.

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 Balances

List the connected PayPal merchant's reporting balances.

List PayPal Disputes

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

List PayPal Invoices

Lists PayPal invoices with pagination and optional total counts.

List Legacy Billing Plans

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

List Payments

Lists PayPal Payments v1 payments for reconciliation or monitoring, with pagination and optional time, payer, and status parameters.

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 PayPal web experience profiles for a merchant or subject, including checkout flow and branding details.

Update checkout order (partial)

Partially updates a PayPal checkout order using JSON Patch operations on patchable properties.

Update billing plan (partial)

Partially updates a PayPal subscription billing plan using JSON Patch operations.

Update Subscription

Partially updates a PayPal subscription by ID using an ordered array of JSON Patch operations.

Update web experience profile (partial)

Partially updates a PayPal web experience profile by ID using JSON Patch operations.

Braintree Ping

Sends a GraphQL ping query to the configured PayPal base URL.

Query Braintree Report

Checks GraphQL connectivity by sending a read-only ping to the configured PayPal endpoint.

Retrieve Payment Resource

Retrieve a PayPal payment resource by its ID.

Search PayPal Invoices

Search for PayPal invoices based on various filter criteria.

Search PayPal Transactions

Search a PayPal merchant's transaction reporting history.

Send Invoice

Sends a draft PayPal invoice by ID.

Send PayPal Invoice Reminder

Sends an ad-hoc payment reminder for an existing PayPal invoice.

Simulate Webhook Event

Simulates a PayPal webhook event to test a webhook integration, using a webhook URL or ID.

Update Dispute

Partially updates a PayPal dispute using an ordered list of 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 by ID using an array of JSON Patch operations.

Update Webhook

Updates a PayPal webhook using JSON Patch operations, including changes to its URL or event subscriptions.

Update template

Fully updates a PayPal invoice template by ID, replacing its existing values with the supplied template data.

Update web experience profile

Updates a PayPal web experience profile by replacing its configuration with the provided values.

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.

FAQ

Frequently asked questions

Start with Paypal.It takes 30 seconds.

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

Start building