Listen LabsDocs

    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:

    Add Listen Labs in ChatGPT

    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:

    Add Listen Labs in Claude

    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

    Setup video

    Open Terminal

    Open your terminal.

    Add the server

    cURL
    codex mcp add listenlabs --url https://listenlabs.ai/mcp

    Authenticate

    Log in, approve access, and use.

    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.

    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

    TokenLifetimeNotes
    Access token1 hourRefreshed automatically by the client
    Refresh token30 daysRe-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.