The Userflow MCP server connects your Userflow account to Claude, ChatGPT, and other AI tools that support MCP. Ask questions in plain language about your flows, users, segments, events, and assistant conversations, and have your AI tool build things for you: flows, segments, charts, and dashboards.
Permissions and access: the Userflow MCP is available to everyone on your team. You connect with your own Userflow login, and the MCP carries the same permissions you already have in the Userflow app—you can see and do exactly what you'd be able to see and do in Userflow itself, and nothing more. There is no separate permission system, usage limit, or access control specific to the MCP: it isn't something you configure per role or restrict independently of a person's existing Userflow role. Now that the MCP can write as well as read, that cuts both ways—if your role doesn't let you publish a flow inside Userflow, it doesn't let you publish one through your AI tool either, and every action is attributed to the teammate who took it. The way to change what someone can do through the MCP is to change their role in Userflow itself (see Managing Teams), or to revoke their individual connection from the connection management screen.
What you can ask
Once connected, you can ask questions in natural language about anything happening in your Userflow account. A few examples:
Your flows
"How many flows do I have published, and which ones are still in draft?"
"When was the 'Welcome Tour' first published, and who's edited it most recently?"
"Which flows are tagged 'Onboarding' and are currently live?"
Performance and analytics
"How many people saw the 'Product Tour' yesterday?"
"What's the completion rate for the 'Trial Signup' flow this month?"
"Compare completion rates between 'Onboarding A' and 'Onboarding B'."
"Summarize the NPS responses we received in the last 30 days."
Your users and companies
"Did jane@acme.com complete the setup flow?"
"Show me all companies in the 'Trial' segment."
"Which users on the Free plan haven't logged in for 10 days?"
Your Adoption Agent
"How many conversations did the Adoption Agent have last week?"
"What are the most common topics customers asked about?"
Your account setup
"List all the events we're tracking."
"What user and company attributes are defined on this account?"
Your help content
"What does our help center say about setting up single sign-on?"
"Find the help article about inviting team members."
"Summarize what our knowledge base covers about billing."
The AI tool will pick the right data to look at based on your question. You can drill in, ask follow-ups, and combine filters the same way you'd talk to a teammate.
What it can do
The MCP doesn't only answer questions. It can also build and change things in your Userflow account, so the flow or segment an answer points to can be created in the same conversation. A few examples:
Build flows and campaigns
"Create a banner announcing Tuesday's maintenance window."
"Duplicate the 'Welcome Tour' and call it 'Welcome Tour: Enterprise'."
"Build an NPS survey for companies who have been customers for more than six months."
Build segments
"Create a segment of companies on a trial that haven't published a flow yet."
"Segment the users who saw the onboarding flow but didn't finish it."
Build charts and dashboards
"Build a funnel chart for activation over the last 30 days and add it to my activation dashboard."
Publish a flow
"Publish the 'Trial Signup' flow."
Creating or editing a flow always produces an unpublished draft, so nothing reaches your users until you say so. Publishing is a separate step that asks you to confirm every time. Segments, charts, and dashboards have no draft state in Userflow, so those are created in your account right away.
For the full picture, including how to keep the MCP read-only if you'd rather, see Creating and publishing with MCP write tools. The launch post, Introducing MCP Write Tools, covers why it's built this way.
Which AI tools can connect
Any AI tool that lets you add a custom MCP server by URL can connect to Userflow. There's no per-tool integration to wait for and no approved-tools list—if your tool can point at an MCP server, it can query your Userflow data.
The steps are the same everywhere:
Find where your tool lets you add a custom MCP server or connector.
Add
https://api.userflow.com/mcpas the server URL.Sign in with your Userflow login to authorize it.
We document Claude and ChatGPT step by step below because they're the two most common, but they aren't special cases—the same URL and the same sign-in work in any tool with custom MCP support.
If you can't find a way to add a custom MCP server in your tool, that tool doesn't support custom MCP connections yet. That's a limitation of the tool, not of Userflow, and it usually changes as vendors add MCP support.
How to connect
Setup has two parts: adding the Userflow MCP as a custom connector in your AI tool, and signing in to authorize it.
You can find Userflow in the ChatGPT connector directory. A native listing in Claude is coming; until then, add Userflow in Claude as a custom connector using the steps below. Adding it by URL works in either tool, and in any other AI tool with custom MCP support.
1. Add the Userflow MCP as a custom connector
Use this server URL wherever your AI tool lets you add a custom MCP or connector:
https://api.userflow.com/mcp
This one URL works for every account, in every region. If your account or some of your environments are hosted in the EU, you still use the same URL—you choose which environment to query within the conversation, and Userflow routes to the right region for you.
In Claude:
Personal account: go to Settings → Connectors, click the + to add a custom connector, enter a name (for example, "Userflow MCP") and the server URL above in the dialog that opens, and click Add. Then complete the sign-in flow to finish connecting.
Team or Enterprise account: an admin adds the connector once using the steps above. After that, anyone on the account can open Settings → Connectors, find the listing the admin created (it has the name they gave it), select it, click Connect, and complete the sign-in flow with their own Userflow login.
In ChatGPT and other AI tools, add the same server URL wherever the tool lets you add a custom MCP or connector.
2. Sign in to authorize
When you click Connect, you're taken to a Userflow sign-in and consent screen in your browser. Sign in to Userflow the way you normally do, review the access you're granting, and approve it. You're redirected back to your AI tool, fully connected—there's no API key to create or paste.
Because you sign in as yourself, the connection carries your own Userflow permissions: you can do exactly what you can do in the Userflow app, and nothing more.
Once authorized, your AI tool can query your Userflow data. Try asking "How many flows do I have published?" to confirm the connection is working.
Already connected during the early beta? If you set up the MCP earlier using a Userflow API key, you'll be asked to sign in again the next time you use it. Just follow the sign-in and consent screen above to reconnect—this applies to EU accounts too. You don't need to remove or re-add the connector.
Managing your connections
You can see every active AI connection to your Userflow account—and revoke any of them at any time—from the connection management screen in your Userflow settings. Revoking a connection immediately stops that AI tool from querying your data until it's authorized again.
What to expect
Structural and analytics questions both work. Flow counts, status, ownership, segment membership, event definitions, and attributes, plus completion rates, drop-off, NPS summaries, and comparative analytics. Most data use cases are covered.
Complex multi-step queries may need rephrasing. If you don't get the answer you expect, try breaking the question into smaller parts.
Need help?
If you run into trouble connecting or have questions about what the MCP can answer, reach out to your Userflow contact or post in the in-app help.