Advertise
MCP.so
Sign In
H

Help Scout MCP Server

@drewburchfield

Repository

Basic information

Category

Other

Transports

stdio

Author

drewburchfield

Submitted by

Drew Burchfield

About Help Scout MCP Server

An MCP server that enables Claude and other AI assistants to interact with Help Scout data

#mcp#model-context-protocol#modelcontextprotocol#mcp-server#help-scout#help-scout-api#helpscout#customer-support#typescript#nodejs

Help Scout MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "helpscout": {
      "command": "npx",
      "args": [
        "help-scout-mcp-server"
      ],
      "env": {
        "HELPSCOUT_API_KEY": "Bearer your-personal-access-token-here",
        "HELPSCOUT_BASE_URL": "https://api.helpscout.net/v2/",
        "ALLOW_PII": "false",
        "CACHE_TTL_SECONDS": "300",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Help Scout MCP Server tools

8

STEP 1: Always use this FIRST when searching conversations. Lists all available inboxes or filters by name. CRITICAL: When a user mentions an inbox by name (e.g., "support inbox", "sales mailbox"), you MUST call this tool first to get the inbox ID before searching conversations.

STEP 2: Search conversations after obtaining inbox ID. WARNING: Always get inboxId from searchInboxes first if user mentions an inbox name. IMPORTANT: Specify status (active/pending/closed/spam) for better results, or use comprehensiveConversationSearch for multi-status searching.

Get conversation summary with first customer message and latest staff reply

Get all thread messages for a conversation

Get current server time for time-relative searches

QUICK HELPER: Lists ALL available inboxes with their IDs. This is equivalent to searchInboxes with empty query but more explicit. Use this when you need to see all inboxes or when starting any inbox-specific search.

Advanced conversation search with complex boolean queries and customer organization support

RECOMMENDED FOR GENERAL SEARCHES: Searches across multiple statuses simultaneously, solving the common issue where searches return no results. WORKFLOW: 1) If user mentions an inbox name, call searchInboxes FIRST to get the ID. 2) Then use this tool with the inbox ID. This tool automatically searches active, pending, and closed conversations.

Overview

What is Help Scout Mcp Server?

This MCP server integrates with the Help Scout API to provide conversation search, customer profile access, mailbox management, and support analytics. It supports Personal Access Token and OAuth2 authentication, includes configurable PII protection, and offers intelligent caching. Designed for support teams using Help Scout.

How to use Help Scout Mcp Server?

Install via NPM, Docker, or direct installation. Configure with your Help Scout API credentials and choose between Personal Access Token or OAuth2 authentication. Full TypeScript support is included.

Key features of Help Scout Mcp Server

  • Search conversations by content, status, tags, and date ranges
  • Access customer profiles and support history
  • Browse mailboxes and workflow data
  • Configurable PII filtering for security
  • Built-in caching and rate limiting
  • Multi-platform distribution (NPM, Docker, direct)

Use cases of Help Scout Mcp Server

  • Search conversations with filters for content, status, tags, and date ranges
  • Access customer profiles and support history for personalized support
  • Manage mailboxes and workflows to streamline processes
  • Analyze support metrics and performance

Frequently asked questions

1

What authentication methods are supported?

Personal Access Token and OAuth2 are both supported.

2

How does PII protection work?

PII filtering is configurable to mask or remove personally identifiable information for security.

3

What are the distribution options?

Available via NPM, Docker, or direct installation with full TypeScript support.

4

Does it include rate limiting?

Yes, built-in rate limiting is included.

5

Is caching available?

Yes, intelligent caching is built in for optimal performance.

Comments

More Other MCP servers

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K
Advertise