Voiceflow MCP overview - Voiceflow Documentation

The Voiceflow MCP server is a remote Model Context Protocol (MCP) server that connects AI clients like Claude Code directly to your Voiceflow account. Once it’s connected, the assistant can work with your projects much like you would in Creator: listing projects, reading and editing prompts, building functions and tools, querying the knowledge base, pulling transcripts, running evaluations, and testing agents, all without copying anything back and forth. It’s a hosted server at https://mcp.voiceflow.com/mcp that authenticates with OAuth, so there are no API keys to manage. You sign in to Voiceflow once, and the assistant acts on the projects your account can access. The setup guide walks through connecting the server to Claude Code.

What you can do

The server exposes Voiceflow’s agent-management surface as tools, grouped by capability:

Area	What the assistant can do
Projects & environments	List projects, manage environments, publish, compile, export, and handle variables and secrets
Agent design	Edit the global prompt, agent instructions, and routing; create and update playbooks and workflows; configure model and voice behavior
Tools	Create and wire functions, API tools, MCP tools, and prebuilt integrations, at the agent or playbook level
Knowledge base	Manage documents and data sources, and run retrieval queries to test coverage
Testing	Run live test conversations through the Dialog Manager and automated end-to-end simulations
Measurement	Fetch and search transcripts, design and run evaluations, and query analytics and usage

What you are approving

Connecting the server grants an OAuth token covering both reading and changing your workspace. There is no API key, and no lesser grant that still produces a working session.

How MCP authentication works

The two scopes, what each covers, and what a client has to support.

How it works

Plain language, not tool names. Once connected, you don’t call tools directly. You describe what you want, for example “pull the last 50 transcripts for my support agent and find where it’s failing”, and the client picks the right tools.
Namespaced tools. Every tool is exposed to the client as mcp__voiceflow__*, so it never collides with other servers you’ve connected.
Scoped to your account. The assistant can only see and change the projects your signed-in Voiceflow account has access to.
Standard OAuth, no shared secret. Authorization code with PKCE (S256), refresh tokens for renewal, and the token sent as a bearer header. Clients can register themselves, so there is nothing to paste and nothing to rotate by hand.

Not sure where to start? After connecting, ask the assistant to “list my Voiceflow projects”. It’s the quickest way to confirm the server is working and see what’s available.

Get started

Set up Voiceflow in Claude Code

Connect the MCP server to Claude Code and sign in with your account.

​What you can do

​What you are approving

How MCP authentication works

​How it works

​Get started

Set up Voiceflow in Claude Code

What you can do

What you are approving

How it works

Get started