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

# Connect Your MCP Client

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

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

## ChatGPT

Listen Labs is officially available in the OpenAI App Store. Add it directly:

[Add Listen Labs in ChatGPT](https://chatgpt.com/apps/listen-labs/asdk_app_6a0765f330f08191a2e5d95f075948a9)

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](https://claude.ai/directory/connectors/listen-labs)

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](https://github.com/MerlinAGI/listen-labs-research-skill) on top of the connector to create, launch, and analyze studies without touching the raw tools.

## Codex

[Setup video](https://www.loom.com/share/4cf84f2e963a42c58795c1dedd164b65)

<Steps>
  <Step title="Open Terminal">
    Open your terminal.
  </Step>

  <Step title="Add the server">
    ```bash theme={null}
    codex mcp add listenlabs --url https://listenlabs.ai/mcp
    ```
  </Step>

  <Step title="Authenticate">
    Log in, approve access, and use.
  </Step>
</Steps>

## 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

<Steps>
  <Step title="Discovery">
    Your MCP client discovers OAuth metadata from the server automatically.
  </Step>

  <Step title="Redirect">
    You are redirected to `https://listenlabs.ai/mcp/authorize` (or prompted to sign in first).
  </Step>

  <Step title="Consent">
    The consent screen shows which application is requesting access and what it can do.
  </Step>

  <Step title="Approve">
    After you approve, the client receives access and refresh tokens.
  </Step>
</Steps>

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