Help Scout Mcp Server

Name: Help Scout Mcp Server
Author: drewburchfield

@drewburchfield

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

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

drewburchfield

投稿者

Drew Burchfield

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

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.

概要

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.

「その他」の他のコンテンツ

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K