
Help Scout
Read-only MCP access to Help Scout conversations, inboxes and email support reports
- Pricing
- Open source
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Help Scout
Help Scout is an open-source MCP server for sales and crm. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http help-scout https://gateway.pipeworx.io/help-scout/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/help-scout/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"help-scout": {
"url": "https://gateway.pipeworx.io/help-scout/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"help-scout": {
"type": "http",
"url": "https://gateway.pipeworx.io/help-scout/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"help-scout": {
"serverUrl": "https://gateway.pipeworx.io/help-scout/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"help-scout": {
"type": "http",
"url": "https://gateway.pipeworx.io/help-scout/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Open source
MIT-licensed npm package; Pipeworx gateway has free anonymous and registered tiers with paid credits above them.
Prices change. Check pipeworx.io before you buy.
Help Scout 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.