Connect Your MCP Client

Add the Listen Labs MCP server to Claude, ChatGPT, or Codex and authenticate with OAuth.

Server URL

https://listenlabs.ai/mcp

You can also use https://mcp.listenlabs.ai/mcp (equivalent endpoint).

The server uses stateless Streamable HTTP: each request is independent. There are no long-lived MCP sessions to manage.

For every client below: after adding the connector, click Connect, sign in to Listen Labs when prompted, click Approve, and start chatting.

Claude

Setup video

1. Open Connectors

   Open Customize → Connectors.

2. Add a custom connector

   Click Add Connector → Add custom connector.

3. Fill in the details

   Name: Listen Labs

   Remote MCP server URL: https://listenlabs.ai/mcp

4. Connect

   Click Add → Connect, then log in, approve access, and use.

ChatGPT

Setup video

1. Open Advanced Settings

   Open Settings → Apps → Advanced Settings.

2. Enable Developer Mode

   Toggle Developer Mode on, then go back.

3. Create the app

   Click Create app.

   Name: Listen Labs

   MCP Server URL: https://listenlabs.ai/mcp

   Authentication: OAuth

4. Create and connect

   Click Create, then log in, approve access, and use.

Codex

Setup video

1. Open Terminal

   Open your terminal.

2. Add the server

   codex mcp add listenlabs --url https://listenlabs.ai/mcp
   
3. Authenticate

   Log in, approve access, and use.

First-time authentication

1. Discovery

   Your MCP client discovers OAuth metadata from the server automatically.

2. Redirect

   You are redirected to https://listenlabs.ai/mcp/authorize (or prompted to sign in first).

3. Consent

   The consent screen shows which application is requesting access and what it can do.

4. Approve

   After you approve, the client receives access and refresh tokens.

Token lifetimes

Token	Lifetime	Notes
Access token	1 hour	Refreshed automatically by the client
Refresh token	30 days	Re-authorize if it expires

You can revoke access by removing the MCP server from your client. OAuth client registrations that go unused are cleaned up automatically after 90 days.

Permissions

When you approve access, the MCP integration can:

• View studies and their details in organizations you belong to
• Read completed respondent transcripts from those studies

The integration acts as you. It only sees studies and responses your Listen Labs user already has access to.