helpscout-mcp

An MCP server that gives AI assistants direct access to your Help Scout inboxes, conversations, customers, organizations, and threads. Search tickets, pull customer and account context, spot patterns, and get answers without leaving your editor or chat window.

Built by a Help Scout customer who wanted to give his support team superpowers. If you handle customer conversations in Help Scout and want AI to help you work faster, this is for you.

What You Can Do

• Search conversations by keyword, date range, status, tag, email domain, or ticket number
• Look up customers by name, advanced query syntax, or exact email address
• Explore organizations with direct customer and conversation traversal
• Pull full thread history into context before drafting a reply
• Get conversation summaries with the original customer message and latest staff response
• Monitor inbox activity across multiple inboxes with a single query
• Stay compliant with optional PII redaction and scoped inbox access

Quick Start

Claude Cowork (Recommended)

Install the helpscout-navigator plugin. It auto-starts the MCP server and includes navigation skills that help Claude pick the right search tool for your query.

1. Open Cowork and go to Customize > Browse plugins > Personal
2. Click + > Add marketplace from GitHub and enter drewburchfield/help-scout-mcp-server
3. Install helpscout-navigator from the marketplace
4. Add your Help Scout credentials (step-by-step guide)

The plugin bundles guided skills, session hooks, and tool selection guidance on top of the MCP server. Other install methods give you the tools; this one also teaches the AI how to use them well.

Claude Desktop

One-click install using Desktop Extensions:

1. Download the latest .mcpb file from releases
2. Double-click to install (or drag into Claude Desktop)
3. Enter your Help Scout App ID and App Secret when prompted

Claude Code

The same helpscout-navigator plugin works in Claude Code with the same navigation skills.

1. Run /plugin in Claude Code to open the marketplace
2. Search for helpscout-navigator and install it
3. Set HELPSCOUT_APP_ID and HELPSCOUT_APP_SECRET as environment variables
4. Restart Claude Code

For Cursor, VS Code, and Other MCP Clients

Add to your MCP client's config file (e.g., claude_desktop_config.json, .cursor/mcp.json):

{
  "mcpServers": {
    "helpscout": {
      "command": "npx",
      "args": ["help-scout-mcp-server"],
      "env": {
        "HELPSCOUT_APP_ID": "your-app-id",
        "HELPSCOUT_APP_SECRET": "your-app-secret"
      }
    }
  }
}

Docker

docker run -e HELPSCOUT_APP_ID="your-app-id" \
  -e HELPSCOUT_APP_SECRET="your-app-secret" \
  drewburchfield/help-scout-mcp-server

Getting Your API Credentials

1. Go to Help Scout > My Apps > Create Private App
2. Select at minimum: Read access to Mailboxes, Conversations, Customers, and Organizations
3. Copy your App ID and App Secret

Help Scout uses OAuth2 Client Credentials flow exclusively. Personal Access Tokens are not supported.

Help Scout UI	Environment Variable
App ID	HELPSCOUT_APP_ID
App Secret	HELPSCOUT_APP_SECRET

Alternative names HELPSCOUT_CLIENT_ID / HELPSCOUT_CLIENT_SECRET and legacy HELPSCOUT_API_KEY are also supported.

Tools

Which tool should I use?