Connect PayPal to Claude Code
Read transactions, balances and disputes, manage invoices and orders, and issue refunds. Add Toolspoke to Claude Code once and it can use 16 PayPal actions. Your PayPal credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install PayPal and connect it
Add PayPal to a project in your Toolspoke workspace.
REST app client credentials. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- Client ID
- PayPal Developer Dashboard (developer.paypal.com) → Apps & Credentials → switch to Live (or Sandbox) → your REST app, or Create App. The Client ID is shown on the app's page. Turn on Transaction Search under the app's features if list_transactions or get_balances should work.
- Secret key
- On the same app page, under Secret key, click Show. PayPal exchanges it for a short-lived access token; the secret itself never reaches an API endpoint.
Choose what Claude Code may do
All 16 actions start on. Switch off any of the 6 actions that change something in PayPal, and Claude Code gets a refusal if it tries.
What you can ask Claude Code for
A few of the PayPal actions that only read, so they are safe to try first.
- Search the account's transactions between two dates, at most 31 days apart
- List the account's balances in every currency it holds, optionally as of a past date-time
- List the account's invoices, newest first, with status, recipient and amount
- Search invoices by recipient email, invoice number or status
What Claude Code can do in PayPal
10 actions read, 2 write and 4 delete or permanently change something.
Reads
List transactions
Search the account's transactions between two dates, at most 31 days apart. Results can lag real time by up to three hours. fields controls how much each row carries: transaction_info returns only the transaction itself; all adds payer, cart and shipping detail. Requires Transaction Search to be enabled on the REST app.
Get balances
List the account's balances in every currency it holds, optionally as of a past date-time. Requires Transaction Search on the REST app.
List invoices
List the account's invoices, newest first, with status, recipient and amount. Takes no required arguments, which is why it is the connection test.
Search invoices
Search invoices by recipient email, invoice number or status.
Get invoice
Retrieve one invoice by id, with its items, recipients, payments and refunds.
Get order
Retrieve one checkout order by id, with its status, payer and any captures.
Get capture
Retrieve one captured payment by id, with its amount, fees and status.
Get refund
Retrieve one refund by id, with its amount and status.
List disputes
List disputes and claims opened against this account, optionally by state.
Get dispute
Retrieve one dispute by id, with the disputed transaction, messages and evidence.
Writes
Create draft invoice
Create a draft invoice to one recipient. A write rather than destructive: a draft is not sent and nobody sees it until send_invoice. Items are [{name, quantity, unit_amount: {currency_code, value}}], with quantity and value as decimal strings.
Create order
Create a checkout order for one amount. A write rather than destructive: no money moves until the payer approves it and capture_order is called. Returns the order id and the approve link to give the payer.
Deletes or permanently changes
Send invoice
Send a draft invoice to its recipient. Destructive because it emails someone outside the workspace a request for money, and a sent invoice cannot be unsent, only cancelled, which notifies them again.
Cancel invoice
Cancel a sent invoice so it can no longer be paid. Destructive because it cannot be reversed and, by default, notifies the recipient.
Capture order
Capture payment for an order the payer has approved. Destructive because it moves the payer's money into this account; undoing it means refund_capture.
Refund capture
Refund a captured payment, in full or in part. Destructive because it sends money back to the payer and cannot be undone. Leave amount out to refund the full capture.
PayPal in Claude Code: questions
Does Claude Code see my PayPal credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Can I stop Claude Code from changing things in PayPal?
Yes. Each of the 16 actions can be switched off for a project. Turn off the 6 that change something and Claude Code can only read.
Will 16 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the PayPal action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a PayPal call does not run in a sandbox, so it bills nothing.
PayPal in your other apps
More payments toolkits for Claude Code
Try PayPal in Claude Code
Free to start, and tool calls cost nothing on any plan.