paypal avatar

Paypal Mcp Server

paypal/paypal-mcp-serverOfficial

This connects Claude directly to PayPal's APIs for payments, invoicing, subscriptions, and order management. You get 30+ tools out of the box: create and send invoices, process orders and refunds, manage disputes, track shipments, handle catalog products, and run subscription billing. It works in both sandbox and production modes, authenticating with PayPal access tokens you generate from your developer dashboard. The setup is straightforward through npx, and you can enable all tools at once or pick specific ones. Useful when you're building payment workflows, need to automate invoice generation, or want conversational access to PayPal operations without writing integration code yourself.

GitHub stars
10
tools
30
auth
Secret needed
transport
STDIO
env vars
2
last updated
Oct 28, 2025

Tools

30 tools

Public tool metadata for what this MCP can expose to an agent.

create_invoiceCreate a new invoice in the PayPal system

Create a new invoice in the PayPal system

No parameter schema in public metadata yet.

list_invoicesList invoices with optional pagination and filtering

List invoices with optional pagination and filtering

No parameter schema in public metadata yet.

get_invoiceRetrieve details of a specific invoice

Retrieve details of a specific invoice

No parameter schema in public metadata yet.

send_invoiceSend an invoice to recipients

Send an invoice to recipients

No parameter schema in public metadata yet.

send_invoice_reminderSend a reminder for an existing invoice

Send a reminder for an existing invoice

No parameter schema in public metadata yet.

cancel_sent_invoiceCancel a sent invoice

Cancel a sent invoice

No parameter schema in public metadata yet.

generate_invoice_qr_codeGenerate a QR code for an invoice

Generate a QR code for an invoice

No parameter schema in public metadata yet.

create_orderCreate an order in PayPal system based on provided details

Create an order in PayPal system based on provided details

No parameter schema in public metadata yet.

get_orderRetrieve the details of an order

Retrieve the details of an order

No parameter schema in public metadata yet.

pay_orderProcess payment for an authorized order

Process payment for an authorized order

No parameter schema in public metadata yet.

create_refundProcess a refund for a captured payment.

Process a refund for a captured payment.

No parameter schema in public metadata yet.

get_refundGet the details for a specific refund.

Get the details for a specific refund.

No parameter schema in public metadata yet.

list_disputesRetrieve a summary of all open disputes

Retrieve a summary of all open disputes

No parameter schema in public metadata yet.

get_disputeRetrieve detailed information of a specific dispute

Retrieve detailed information of a specific dispute

No parameter schema in public metadata yet.

accept_dispute_claimAccept a dispute claim

Accept a dispute claim

No parameter schema in public metadata yet.

create_shipment_trackingCreate a shipment tracking record

Create a shipment tracking record

No parameter schema in public metadata yet.

get_shipment_trackingRetrieve shipment tracking information

Retrieve shipment tracking information

No parameter schema in public metadata yet.

create_productCreate a new product in the PayPal catalog

Create a new product in the PayPal catalog

No parameter schema in public metadata yet.

list_productsList products with optional pagination and filtering

List products with optional pagination and filtering

No parameter schema in public metadata yet.

show_product_detailsRetrieve details of a specific product

Retrieve details of a specific product

No parameter schema in public metadata yet.

update_productUpdate an existing product

Update an existing product

No parameter schema in public metadata yet.

create_subscription_planCreate a new subscription plan

Create a new subscription plan

No parameter schema in public metadata yet.

update_planUpdate an existing plan

Update an existing plan

No parameter schema in public metadata yet.

list_subscription_plansList subscription plans

List subscription plans

No parameter schema in public metadata yet.

show_subscription_plan_detailsRetrieve details of a specific subscription plan

Retrieve details of a specific subscription plan

No parameter schema in public metadata yet.

create_subscriptionCreate a new subscription

Create a new subscription

No parameter schema in public metadata yet.

show_subscription_detailsRetrieve details of a specific subscription

Retrieve details of a specific subscription

No parameter schema in public metadata yet.

update_subscriptionupdate an existing subscription

update an existing subscription

No parameter schema in public metadata yet.

cancel_subscriptionCancel an active subscription

Cancel an active subscription

No parameter schema in public metadata yet.

list_transactionsList transactions with optional pagination and filtering

List transactions with optional pagination and filtering

No parameter schema in public metadata yet.

Sponsors

Configuration

PAYPAL_ACCESS_TOKEN*secret

YOUR_PAYPAL_ACCESS_TOKEN ref: https://docs.paypal.ai/developer/how-to/api/get-started

PAYPAL_ENVIRONMENT*

'SANDBOX' or 'LIVE'

Readme

PayPal Model Context Protocol

The PayPal Model Context Protocol server allows you to integrate with PayPal APIs through function calling. This protocol supports various tools to interact with different PayPal services.

To run the PayPal MCP server using npx, use the following command:

npx -y @paypal/mcp --tools=all PAYPAL_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" PAYPAL_ENVIRONMENT="SANDBOX"

Replace YOUR_ACCESS_TOKEN with your PayPal access token. Refer this on how to generate a PayPal access token. Alternatively, you could set the PAYPAL_ACCESS_TOKEN in your environment variables.

Usage with MCP host (Claude Desktop/Cline/Cursor/GitHub Copilot)

This guide explains how to integrate the PayPal connector with Claude Desktop.

Prerequisites

  • Claude Desktop application installed
  • installing Node.js locally

Installation Steps

1. Install Node.js

Node.js is required for the PayPal connector to function:

  1. Visit the Node.js official website, download and install it.
  2. Requirements: Node 18+

View the full README on GitHub

Details

Repository
github.com/paypal/paypal-mcp-server
Categories
Communication & Messaging, Finance & Commerce
Package
@paypal/mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1embeddedlayers avatarMCP Analyticsembeddedlayers/mcp-analyticsA statistical analyst in your AI chat: bring data and a question, get a citable, re-runnable report.9stars
2madaburns avatarBlackVeil DNS & Email Security Scannermadaburns/bv-mcpDNS and email security scanner with 82 MCP tools for SPF, DMARC, DNSSEC, SSL, and brand audits.0stars
3theastraway avatarMINDtheastraway/mind-mcp-serverMIND knowledge-graph memory for agents. 44 tools: CRM, Life, MoneyMIND, Budget, Sheets, Email, Sign.7stars
4puffo-ai avatarHuddopuffo-ai/huddo-mcpGroup chat for people and AI agents: join a room by invite link, read, reply, whisper, wait.6stars
5frontsail-ai avatarAspiciofrontsail-ai/aspicioDXF and PDF/X-4 for AI agents: structured facts, PNG renders, an interactive in-chat viewer.6stars
6gabrielmahia avatarMpesa Mcpgabrielmahia/mpesa-mcpM-Pesa Daraja and Africa's Talking MCP server: 24 tools; live payments and SMS need confirmation.6stars