Un-Official PayPal MCP Server

What is Un-Official PayPal MCP Server?

A Python implementation of the Model Context Protocol (MCP) that enables LLMs to interact with PayPal APIs through function calling. It supports major PayPal endpoints including invoices, orders, products, subscriptions, shipments, disputes, and transactions.

How to use Un-Official PayPal MCP Server?

Install via pip (pip install paypal-mcp-server), from source, or with Docker. Run the paypal-mcp command with --tools (e.g., --tools=all) and provide your PayPal access token and environment (SANDBOX or PRODUCTION) via environment variables or command-line arguments. Integrate with Claude Desktop by adding the server configuration to ~/Claude/claude_desktop_config.json.

Key features of Un-Official PayPal MCP Server?

• Full MCP implementation for PayPal API integrations
• Supports invoices, orders, products, subscription plans, subscriptions, shipments, disputes, and transactions
• CLI with optional tool filtering (--tools=...)
• Docker image available for containerized deployment
• Configurable via environment variables or command-line arguments
• Compatible with PayPal’s Agent Toolkit

Use cases of Un-Official PayPal MCP Server?

• Automate invoice creation, sending, and tracking for billing workflows
• Manage order lifecycle (create, get, capture) via LLM-driven assistants
• Track shipments and handle dispute resolution through chat interfaces
• List and filter transaction history for financial reporting
• Create and manage subscription plans and subscriptions

FAQ from Un-Official PayPal MCP Server

How do I obtain a PayPal access token?

Use a POST request to PayPal’s OAuth2 token endpoint with your client ID and client secret. Example: curl -v https://api-m.sandbox.paypal.com/v1/oauth2/token -H "Accept: application/json" -u "CLIENT_ID:CLIENT_SECRET" -d "grant_type=client_credentials".

Can I enable only specific tools?

Yes. Use the --tools flag with a comma-separated list, e.g., paypal-mcp --tools=invoices.create,invoices.list,orders.create --access-token=your_token.

What environments are supported?

You can set PAYPAL_ENVIRONMENT to "SANDBOX" (default) or "PRODUCTION".

How do I integrate with Claude Desktop?

Add the server configuration under mcpServers in your claude_desktop_config.json, specifying the command, arguments, and environment variables for the access token and environment.

What are the runtime dependencies?

The server is a Python package installed via pip. It requires a PayPal access token and network access to PayPal’s API endpoints.