Skip to main content

​
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.

​
ChatGPT

Listen Labs is officially available in the OpenAI App Store. Add it directly: Add Listen Labs in ChatGPT Or, in ChatGPT go to Apps → search Listen Labs → add the connector.

​
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 LabsRemote MCP server URL: https://listenlabs.ai/mcp
4

Connect

Click Add → Connect, 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

TokenLifetimeNotes
Access token1 hourRefreshed automatically by the client
Refresh token30 daysRe-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 and analysis from those studies
  • Create and edit studies where you have edit access
  • Launch studies and start recruitment where you have permission to do so
The integration acts as you and respects the same permissions as the web app. It only sees and changes studies your Listen Labs user already has access to. Creating and editing require edit access on the study or organization, launching requires permission to start recruitment, and read-only tools require at least view access.