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

# Pillow MCP

> Connect ChatGPT, Claude, and other MCP clients to Pillow with browser-based organization auth

Pillow MCP lets ChatGPT, Claude, and other MCP clients connect to Pillow's hosted, read-only endpoint for your organization.

Use MCP when you want an agent to browse studies, read Pillow\.md context, read and search interview transcripts, sample raw messages, or review pre-computed analyses such as Q\&A patterns, issue insights, engagement funnels, and metadata breakdowns. MCP uses your Pillow account and active organization instead of long-lived API keys.

## Endpoint

Use this hosted endpoint in your MCP client:

```txt theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://mcp.trypillow.ai/mcp
```

The endpoint is remote and OAuth-protected. The first connection opens Pillow in your browser so you can sign in and choose the organization the client may access.

## Connect ChatGPT

ChatGPT supports remote MCP servers through custom connectors and MCP apps when your plan and workspace settings allow it.

<Steps>
  <Step title="Open connector settings">
    In ChatGPT, open the settings area for apps, connectors, or developer mode.
    If you are on a Team, Business, Enterprise, or Edu workspace, an admin may
    need to enable custom MCP connectors first.
  </Step>

  <Step title="Add a custom MCP connector">
    Create a custom connector named Pillow and use
    `https://mcp.trypillow.ai/mcp` as the MCP server endpoint.
  </Step>

  <Step title="Authorize Pillow">
    Start the connector flow. ChatGPT opens Pillow in your browser. Sign in with
    your Pillow dashboard account and approve access for the right organization.
  </Step>

  <Step title="Use it in ChatGPT">
    Ask ChatGPT to use Pillow when you need study metadata, Pillow\.md context,
    issue insights, or interview details.
  </Step>
</Steps>

## Connect Claude

Claude supports remote MCP connectors for hosted MCP servers.

<Steps>
  <Step title="Open connector settings">
    In Claude, open the integrations, connectors, or MCP settings for your
    account or workspace.
  </Step>

  <Step title="Add Pillow">
    Add a custom MCP connector named Pillow and use
    `https://mcp.trypillow.ai/mcp` as the remote MCP server URL.
  </Step>

  <Step title="Authorize Pillow">
    Claude opens Pillow in your browser. Sign in with your Pillow dashboard
    account and approve the organization you want Claude to read from.
  </Step>

  <Step title="Confirm tools are available">
    After authorization, Pillow tools should appear in Claude for the connected
    workspace.
  </Step>
</Steps>

## Connect Claude Code

If you use Claude Code locally, add Pillow as an HTTP MCP server:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
claude mcp add --transport http pillow https://mcp.trypillow.ai/mcp
```

Then start Claude Code and complete the browser authorization flow when prompted.

## Generic MCP config

For clients that accept JSON MCP configuration, use this shape:

```json title="mcp-config.json" theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "mcpServers": {
    "pillow": {
      "type": "http",
      "url": "https://mcp.trypillow.ai/mcp"
    }
  }
}
```

Some clients call the HTTP transport `streamable-http` or expose it through a UI instead of a JSON file. Use the same endpoint either way.

## Supported tools

| Tool                    | What it returns                                                       |
| ----------------------- | --------------------------------------------------------------------- |
| `get_connection_info`   | The current connection scope and how to switch Pillow organizations   |
| `get_pillow_context`    | Saved Pillow\.md product context for your organization                |
| `list_studies`          | Studies visible to your organization                                  |
| `get_study`             | Study metadata, status, goals, brief summary, and aliases             |
| `get_study_issues`      | Issue insights for one study                                          |
| `get_qa_patterns`       | Recurring questions and answer distributions for one study            |
| `get_metadata_overview` | Metadata fields and value distributions across a study's interviews   |
| `get_interview_stats`   | Per-interview message counts, duration, and word counts               |
| `get_engagement_funnel` | How far interviews progressed, with average and median message counts |
| `list_interviews`       | Paginated interview summaries for a study                             |
| `get_interview`         | Paginated transcript messages for one interview in a study            |
| `get_message_samples`   | An evenly distributed sample of raw messages, with optional filters   |
| `search_interviews`     | Search across one study's interview transcripts                       |
| `compare_interviews`    | Compare 2-3 topics and their interview overlap across a study         |

MCP clients that support resources can also read `pillow://context/Pillow.md`.

## Security model

* MCP access is read-only.
* Each connection is authorized through Pillow and only ever accesses the one organization you approve.
* Pillow records connection activity for security and never logs your access tokens or transcript text.

## Switch organizations

Each connection is scoped to one organization. To switch, disconnect Pillow from your MCP client and reconnect, then choose the organization you want on the Pillow consent screen.

## Disconnect a client

Remove Pillow from your MCP client config or revoke the client session from the client if it supports OAuth session management. You can reconnect later through the same browser-based flow.

## What's next?

<CardGroup cols={2}>
  <Card title="Organization settings" icon="settings" href="/account/organization">
    Update your organization profile and branding.
  </Card>

  <Card title="Review interviews" icon="messages-square" href="/guides/review-conversations">
    Learn how Pillow stores and displays interview transcripts.
  </Card>
</CardGroup>