help-scout-mcp-server

Overview

An MCP server that provides AI assistants with direct access to Help Scout inboxes, conversations, customers, organizations, and threads. It allows support teams to search tickets by keyword, date range, status or tag, look up customers by name or email, explore organizations, pull thread history, and monitor inbox activity. The server implements OAuth2 Client Credentials flow for secure authentication and includes optional PII redaction for compliance purposes.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• searchConversations

  List recent tickets from Help Scout

  Try:Show me active tickets from this weekTry:List recent customer inquiries
• comprehensiveConversationSearch

  Find conversations by keyword or complex criteria

  Try:Find conversations about billing errorsTry:Search for discussions regarding product features
• structuredConversationFilter

  Look up a specific conversation by ticket number

  Try:Show me ticket #42839Try:Find conversation with ID 12345
• advancedConversationSearch

  Apply complex filters to conversation searches

  Try:All @acme.com conversations tagged urgentTry:Find conversations from last month with status 'pending'
• listCustomers

  Browse customers by name or criteria

  Try:Show customers named JaneTry:List customers with premium support
• searchCustomersByEmail

  Find a customer by exact email address

  Try:Find customer jane@acme.comTry:Look up support@example.com
• getCustomer

  Retrieve detailed information about a specific customer

  Try:Open customer 12345Try:Get details for customer profile 67890
• getCustomerContacts

  Pull customer contact channels and details

  Try:Show contact details for customer 12345Try:List all contact methods for customer profile 67890
• listOrganizations

  Browse organizations in Help Scout

  Try:Show the busiest organizationsTry:List all organizations
• getOrganization

  Retrieve detailed information about a specific organization

  Try:Open organization 456Try:Get details for company profile 789
• getOrganizationMembers

  List customers within a specific organization

  Try:Who belongs to organization 456?Try:Show all members of company 789
• getConversationSummary

  Get a quick overview of a conversation

  Try:Summarize this conversationTry:Give me a brief overview of ticket 12345

Comparable tools

Installation

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

npm install -g help-scout-mcp-server

FAQ

What authentication method does this server use?

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

How do I get API credentials from Help Scout?

Go to Help Scout > My Apps > Create Private App, select at minimum Read access to Mailboxes, Conversations, Customers, and Organizations, then copy your App ID and App Secret.

Can I restrict the server to a specific inbox?

Yes, set the HELPSCOUT_DEFAULT_INBOX_ID environment variable to limit searches to a specific inbox.

Compare help-scout-mcp-server with