> ## Documentation Index
> Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up Voiceflow in Cursor

> Add the Voiceflow MCP server to Cursor by editing mcp.json, then sign in through the browser when Cursor prompts you.

Cursor keeps MCP servers in a JSON file, either for one project or for every project you open.

## Add the server

**1. Open the configuration file**

| Scope | File |
| - | - |
| Every project | `~/.cursor/mcp.json` |
| This project only | `.cursor/mcp.json` |

Create the file if it does not exist.

**2. Add Voiceflow**

```json theme={null}
{
  "mcpServers": {
    "voiceflow": {
      "url": "https://mcp.voiceflow.com/mcp"
    }
  }
}
```

A remote server needs only `url`. Do not add a token: the server uses OAuth, and Cursor handles the exchange.

**3. Sign in**

Cursor prompts you to authenticate the server and opens your browser. Approve the request, and the tab redirects back.

See [Authentication](/docs/mcp/authentication.md) for what the grant covers.

**4. Confirm it worked**

Ask Cursor to **list your Voiceflow projects**. A list means the transport, the grant, and your account access are all working.

## If it does not connect

| Symptom | Likely cause |
| - | - |
| The server never appears | The JSON is malformed, or it went in under `servers` rather than `mcpServers` |
| It appears but has no tools | The OAuth flow did not finish. Reconnect and complete the browser step |
| Tools exist but every call fails | The signed-in account cannot reach the workspace you are asking about |

To disconnect, remove the `voiceflow` entry. That drops Cursor's copy of the token; revoke access in Voiceflow to end every client's session at once.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.