MCP.so
Sign In
H

Help Scout Mcp Server

@drewburchfield

Repository

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

Basic information

Category

Other

Transports

stdio

Publisher

drewburchfield

Submitted by

Drew Burchfield

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"
      }
    }
  }
}

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

FAQ from Help Scout Mcp Server

What authentication methods are supported?

Personal Access Token and OAuth2 are both supported.

How does PII protection work?

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

What are the distribution options?

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

Does it include rate limiting?

Yes, built-in rate limiting is included.

Is caching available?

Yes, intelligent caching is built in for optimal performance.

Comments

More Other MCP servers

Awesome Mcp Servers

punkpeye

A collection of MCP servers.

90.5K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K