Skip to main content
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:
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.
1

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

Add a custom MCP connector

Create a custom connector named Pillow and use https://mcp.trypillow.ai/mcp as the MCP server endpoint.
3

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

Use it in ChatGPT

Ask ChatGPT to use Pillow when you need study metadata, Pillow.md context, issue insights, or interview details.

Connect Claude

Claude supports remote MCP connectors for hosted MCP servers.
1

Open connector settings

In Claude, open the integrations, connectors, or MCP settings for your account or workspace.
2

Add Pillow

Add a custom MCP connector named Pillow and use https://mcp.trypillow.ai/mcp as the remote MCP server URL.
3

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

Confirm tools are available

After authorization, Pillow tools should appear in Claude for the connected workspace.

Connect Claude Code

If you use Claude Code locally, add Pillow as an HTTP MCP server:
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:
mcp-config.json
{
  "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

ToolWhat it returns
get_connection_infoThe current connection scope and how to switch Pillow organizations
get_pillow_contextSaved Pillow.md product context for your organization
list_studiesStudies visible to your organization
get_studyStudy metadata, status, goals, brief summary, and aliases
get_study_issuesIssue insights for one study
get_qa_patternsRecurring questions and answer distributions for one study
get_metadata_overviewMetadata fields and value distributions across a study’s interviews
get_interview_statsPer-interview message counts, duration, and word counts
get_engagement_funnelHow far interviews progressed, with average and median message counts
list_interviewsPaginated interview summaries for a study
get_interviewPaginated transcript messages for one interview in a study
get_message_samplesAn evenly distributed sample of raw messages, with optional filters
search_interviewsSearch across one study’s interview transcripts
compare_interviewsCompare 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?

Organization settings

Update your organization profile and branding.

Review interviews

Learn how Pillow stores and displays interview transcripts.