How to integrate Paypal MCP with Codex

Connect Codex 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.

78 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With Paypal MCP integration, you can draft, triage, summarise emails, and much more, all without leaving the terminal or the app, whichever you prefer.

Also integrate Paypal with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Paypal MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

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.

Conclusion

You've successfully integrated Paypal with Codex using Composio's MCP server. Now you can interact with Paypal directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Paypal operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1000+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Paypal operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
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

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