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.

​
What your assistant can read

​
Server URL

​
ChatGPT

On individual ChatGPT plans that support custom connectors, add the server URL above yourself under Settings → Connectors with developer mode enabled.

​
ChatGPT workspaces

For teams, Privy connects to ChatGPT as a workspace connector, managed by your ChatGPT workspace admin.
1

Admin: add the connector

A workspace admin (ChatGPT Business, Enterprise, or Edu) goes to Settings → Connectors, creates a custom connector named Privy with the MCP server URL above, selects OAuth authentication, and publishes it to the workspace.
2

Connect your Privy account

Each user connects individually: open Settings → Connectors, find Privy, and click Connect. ChatGPT opens a browser window — log in to Privy and select your business.
3

Use it in a chat

Enable the Privy connector from the tools menu in the composer, then ask ChatGPT about your account — for example, “What’s my list growth this quarter, email vs SMS?”

​
Claude

On individual Claude plans, add the connector yourself: go to Settings → Connectors, click Add custom connector, and enter 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: add the connector

A Claude admin goes to Admin settings → Connectors, adds a connector named Privy with the MCP server URL above, 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

Add the server 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 — only businesses on a paid plan are shown in the business picker.
  • Requests start failing after working fine — disconnect and reconnect the server in your assistant to start a fresh session.