# Help Scout

> Help Scout is an open-source MCP server for sales and crm. Read-only MCP access to Help Scout conversations, inboxes and email support reports. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/help-scout
- **Repository:** https://github.com/pipeworx-io/mcp-help-scout
- **MCP Registry name:** io.github.pipeworx-io/help-scout
- **Categories:** [sales and CRM](https://ai-powered.com/categories/sales-and-crm)
- **Listing updated:** 2026-11-18

## About

The README says this server reads support conversations, inboxes and email service metrics from the Help Scout Inbox API through the Pipeworx gateway. It is a read-only bridge, so an assistant can look up a specific case, list queues or pull response and resolution figures without changing anything in the helpdesk.

Authentication uses a Help Scout OAuth 2 access token passed as an argument on each call. The README notes those tokens expire and must be refreshed through Help Scout's own authorization flow. Requests can also be routed through the wider Pipeworx gateway, which lists shared meta-tools alongside the four pack tools.

The server suits support leads and developers who want an assistant to summarise open queues or check how a case progressed. It is an unofficial integration and is not published by Help Scout.

## Features

- **Conversation search and lookup:** Filters support conversations and retrieves a single conversation with customer, inbox, assignee and status details.
- **Optional thread retrieval:** Can include the message threads of one conversation when the full exchange is needed.
- **Inbox listing:** Lists the inboxes the token can access, with IDs, names and email addresses.
- **Email support reporting:** Reports email volume, replies, response time and resolution metrics over a bounded date range.
- **Read-only access:** The README states the pack only reads data and does not modify Help Scout records.

## Good for

- Summarise the status and history of a specific customer support case
- List open support queues before routing or filtering work
- Measure first-response and resolution times for a reporting period
- Check how many conversations an inbox or tag received recently

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http help-scout https://gateway.pipeworx.io/help-scout/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/help-scout/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "help-scout": {
      "url": "https://gateway.pipeworx.io/help-scout/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "help-scout": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/help-scout/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "help-scout": {
      "serverUrl": "https://gateway.pipeworx.io/help-scout/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "help-scout": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/help-scout/mcp"
    }
  }
}
```

## Tools

- `helpscout_list_conversations`: Filter and search support conversations.
- `helpscout_get_conversation`: Retrieve one conversation, optionally with threads.
- `helpscout_list_inboxes`: List accessible inboxes.
- `helpscout_email_report`: Measure email support volume, response time, and resolution.

## FAQ

### How does the server authenticate with Help Scout?

It takes a Help Scout OAuth 2 access token passed as the _apiKey argument. The README says tokens expire and must be obtained or refreshed through Help Scout's authorization-code or client-credentials flow.

### Can it change conversations or send replies?

No. The README states the pack is read-only.

### Which tools does the endpoint list?

The four pack tools are helpscout_list_conversations, helpscout_get_conversation, helpscout_list_inboxes and helpscout_email_report. The endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx.

### Is it official Help Scout software?

No. The README describes it as an independent, unofficial integration not endorsed by the upstream provider.

### Is Help Scout free?

Yes. Help Scout is open source, so you can use and self-host it for free.

### How do I add Help Scout to Claude Code?

Run this command in your terminal: claude mcp add --transport http help-scout https://gateway.pipeworx.io/help-scout/mcp

### What are the best alternatives to Help Scout?

The closest alternatives to Help Scout are Hubspot, Gladly MCP by usefulapi, SupportBee MCP by usefulapi, Groove MCP by usefulapi and Re:amaze MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Hubspot](https://ai-powered.com/mcp/hubspot-3): Hubspot is a freemium MCP server for sales and crm.
- [Gladly MCP by usefulapi](https://ai-powered.com/mcp/gladly-mcp-by-usefulapi): Gladly MCP by usefulapi is a freemium MCP server for sales and crm.
- [SupportBee MCP by usefulapi](https://ai-powered.com/mcp/supportbee-mcp-by-usefulapi): SupportBee MCP by usefulapi is a freemium MCP server for sales and crm.
- [Groove MCP by usefulapi](https://ai-powered.com/mcp/groove-mcp-by-usefulapi): Groove MCP by usefulapi is a freemium MCP server for sales and crm.
- [Re:amaze MCP by usefulapi](https://ai-powered.com/mcp/re-amaze-mcp-by-usefulapi): Re:amaze MCP by usefulapi is a freemium MCP server for sales and crm.
- [HelpCrunch MCP by usefulapi](https://ai-powered.com/mcp/helpcrunch-mcp-by-usefulapi): HelpCrunch MCP by usefulapi is a freemium MCP server for sales and crm.
- [InboxMCP](https://ai-powered.com/mcp/inboxmcp): InboxMCP is an MCP server for communication.
- [Pipeline CRM MCP by usefulapi](https://ai-powered.com/mcp/pipeline-crm-mcp-by-usefulapi): Pipeline CRM MCP by usefulapi is a freemium MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/help-scout
