MCP Server
Connect Your MCP Client
Add the Listen Labs MCP server to Claude, ChatGPT, or Codex and authenticate with OAuth.
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:
Or, in ChatGPT go to Apps → search Listen Labs → add the connector.
Claude
Listen Labs is officially available in the Claude connector directory. Add it directly:
Or, in Claude go to Customize → Connectors → Browse connectors → search Listen Labs → Connect, then log in and approve access.
Prefer plain-English research workflows? Add the Listen Labs research skill on top of the connector to create, launch, and analyze studies without touching the raw tools.
Codex
Open Terminal
Open your terminal.
Add the server
Authenticate
Log in, approve access, and use.
Server URL
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.
First-time authentication
Discovery
Your MCP client discovers OAuth metadata from the server automatically.
Redirect
You are redirected to https://listenlabs.ai/mcp/authorize (or prompted to sign in first).
Consent
The consent screen shows which application is requesting access and what it can do.
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 |
Removing the MCP server from your client stops it from making new requests, but does not revoke its tokens. They expire on the schedule above. To revoke access sooner, contact support@listenlabs.ai. 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 workspaces you belong to
- Read respondent transcripts (completed and in progress, each marked with
is_complete) 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
- Organize studies into folders, and create, rename, move, or delete folders
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 workspace, launching requires permission to start recruitment, and read-only tools require at least view access. On restricted studies, only your study role counts. See Study Permissions.