Skip to main content
The Privy MCP server lets AI assistants read what your Privy account has set up — campaigns, contacts, coupons, displays, flows, orders, segments, and store products — so you can ask questions like “How did my welcome flow do last month?” or “Which of my popups converts best?” directly in ChatGPT, Claude, or any MCP-compatible assistant. All tools are read-only. Assistants can look at your data; they can’t change anything in your account.

​
Requirements

  • A paid Privy plan.
  • An AI assistant that supports remote MCP servers with OAuth.
You don’t need to create an API token or OAuth application. When your assistant first connects, it opens a browser window where you log in to Privy and pick a business — the same login you use for the Privy dashboard. If every business on your login is on a free plan, the window shows that a paid plan is required instead of the picker. If you have both paid and free businesses, the picker leads with the paid ones; free businesses can appear disabled with a free plan — upgrade required label.

​
What your assistant can read

​
Server URL

​
ChatGPT

​
ChatGPT personal

On individual ChatGPT paid plans, you first need to enable Developer Mode in Settings → Security & login → Developer mode. Next, visit Plugins and hit the + button to add a Custom Plugin. Name the Custom Plugin “Privy” and add the server URL above yourself. See the overview video below.

​
Claude

​
Claude personal

Privy is available in the Claude Connectors Directory. Open the Privy listing and click Connect, or search for Privy under Settings → Connectors in Claude web or desktop. If you can’t use the directory, you can add a custom connector with the server URL above.

​
Claude organizations

On Claude Team and Enterprise plans, Privy connects to Claude’s web and desktop apps as an organization connector, managed by a Claude admin.
1

Admin: enable Privy from the directory

A Claude admin goes to Admin settings → Connectors, finds Privy in the Connectors Directory, and enables it for the organization.
2

Connect your Privy account

In a chat, open the tools menu, find Privy, and click Connect. Claude opens a browser window — log in to Privy and select your business.
3

Use it in a chat

With the Privy connector enabled, ask Claude about your account — for example, “How did my abandoned cart flow perform last month?”

​
Claude Code

Privy can be installed from the Connectors Directory or added from your terminal:
The first time Claude Code uses a Privy tool, it opens a browser window to log in and select your business.

​
Gemini CLI

Add the server from your terminal:
Gemini CLI discovers the OAuth requirement automatically and opens a browser window to log in and select your business. If you aren’t prompted, run /mcp auth privy inside the CLI to start the login.

​
Cursor

Add Privy to ~/.cursor/mcp.json (or a project’s .cursor/mcp.json):
Cursor prompts you to authenticate with Privy the first time the server is used.

​
Other MCP clients

Any client that supports remote MCP servers with OAuth works with this standard configuration:

​
Disconnecting

Remove the Privy server from your assistant’s MCP or connector settings. That ends the assistant’s access; reconnecting requires logging in to Privy again.

​
Troubleshooting

  • Login succeeds but the connection fails — make sure your account is on a paid Privy plan. If it is and connecting still fails, contact Support.
  • No business appears during login — if every business is on a free plan, the login window shows that a paid plan is required instead of the picker.
  • Requests return paid_plan_required — the selected business is on a free plan. Upgrade the plan; reconnecting alone will not restore access.
  • Requests start failing after working fine — the business may have moved to a free plan. Upgrade the plan; reconnecting alone will not restore access.