erica-helpscout-mcp

MCP server for accessing HelpScout conversations and tickets.

Installation

npx -y erica-helpscout-mcp

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "erica-helpscout": {
      "command": "npx",
      "args": ["-y", "erica-helpscout-mcp"],
      "env": {
        "HELPSCOUT_APP_ID": "your-app-id-here",
        "HELPSCOUT_APP_SECRET": "your-app-secret-here"
      }
    }
  }
}

Tools Available

| Tool | Description | |------|-------------| | helpscout_search_by_email | Search conversations by customer email address | | helpscout_search_by_domain | Search conversations by domain in subject line | | helpscout_search | Search with custom query (subject, body, tags, etc.) | | helpscout_get_conversation | Get full conversation details with all threads | | helpscout_list_recent | List recent conversations |

Usage Examples

Once configured, ask Claude:

• "Find HelpScout tickets for [email protected]"
• "Search HelpScout for conversations about 90daykorean.com"
• "Get conversation #12345 from HelpScout"
• "Show me recent open tickets in HelpScout"

OAuth Credentials

Get your HelpScout App ID and Secret:

1. Go to HelpScout → Your Profile → My Apps
2. Click "Create My App"
3. Enter an app name and a redirect URL (can be https://google.com for client credentials)
4. Copy the App ID and App Secret to your Claude config