search_help_scoutLABSCO SUMMARY
Two flags stand between an agent and an email your customer will read.
A default install advertises three read tools and nothing else. Turning on writes adds drafts, notes, tags, status and assignment — none of which email anybody — and reaching the customer needs a second flag plus per-call confirmation naming the operation and the target, or the call is refused before it leaves the server. Deletes and admin configuration are not exposed under any flag, and any write can be sent with a dry-run switch to see the exact request first.
What it is
An MCP server for Help Scout that keeps its advertised surface small: three tools handle discovery, schema loading and execution, and every supported read operation is reached through them rather than crowding the client's tool list.
What you get
search_help_scoutto find the right operation by intent,describe_help_scoutto load its schema, andread_help_scoutto run it — 55 read operations across the Mailbox and Docs APIs- Conversations:
searchConversationsby keyword, date, status, tag, email domain or ticket number, plusgetConversation,getConversationSummaryandgetThreadsfor the full history - Customers and organizations:
listCustomers,searchCustomersByEmail,getCustomer,getCustomerContacts,listOrganizations,getOrganizationMembers,getOrganizationConversations - Docs knowledge base:
searchDocsArticlesandgetDocsArticle, through the separate Docs API - Reports and metadata across conversations, channels, productivity, happiness, users, teams and routing
- An optional fourth tool for writes — drafts, internal notes, tags, status, assignment and snooze — that only appears when an operator enables it
Requirements
A Help Scout private app, giving you HELPSCOUT_APP_ID and HELPSCOUT_APP_SECRET — OAuth2 client credentials only, personal access tokens are not supported. Knowledge base tools additionally need HELPSCOUT_DOCS_API_KEY. Install the bundle for Claude Desktop with no Node required, or run the npm package with npx. HELPSCOUT_DEFAULT_INBOX_ID scopes searches to one inbox, and REDACT_MESSAGE_CONTENT replaces message bodies with placeholders.
Setup effort
One command plus credentials — npx help-scout-mcp-server@2.1.0, then supply credentials
USE CASES
Pulling a ticket's full history before you reply
Find the conversation, then read every thread on it so the reply is not written from the subject line.
Getting the account context behind a ticket
Look the customer up by email, then read the organization's other conversations.
Spotting a pattern across the week
Search by keyword and date range across inboxes and read the summaries rather than each thread.
Answering from the knowledge base instead of from memory
Search the Docs articles and open the one that actually covers the case.
Letting an agent draft without letting it send
Enable writes but leave customer-visible writes off, so drafts and internal notes are as far as it goes.
4 tools
Listed in project docs. Your client may show a different list.
describe_help_scoutread_help_scoutwrite_help_scoutBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- npx on PATH
- HELPSCOUT_APP_ID in your environment
- HELPSCOUT_APP_SECRET in your environment
INSTALLATION
Connect your client
Server setup
npx help-scout-mcp-server@2.1.0MCP Clients
Claude Desktop, Claude Cowork
Download the latest .mcpb file from releases, double-click to install (or drag into Claude Desktop), enter your Help Scout App ID and App Secret in the extension settings, restart Claude Desktop. One install covers both Chat and Cowork sessions.
Claude Code
claude mcp add helpscout \
--env HELPSCOUT_APP_ID=<YOUR_HELPSCOUT_APP_ID> \
--env HELPSCOUT_APP_SECRET=<YOUR_HELPSCOUT_APP_SECRET> \
-- npx -y help-scout-mcp-serverCursor
{
"mcpServers": {
"helpscout": {
"command": "npx",
"args": [
"help-scout-mcp-server@2.1.0"
],
"env": {
"HELPSCOUT_APP_ID": "<YOUR_HELPSCOUT_APP_ID>",
"HELPSCOUT_APP_SECRET": "<YOUR_HELPSCOUT_APP_SECRET>",
"HELPSCOUT_DOCS_API_KEY": "optional-docs-api-key"
}
}
}
}VS Code
{
"servers": {
"helpscout": {
"command": "npx",
"args": [
"help-scout-mcp-server@2.1.0"
],
"env": {
"HELPSCOUT_APP_ID": "<YOUR_HELPSCOUT_APP_ID>",
"HELPSCOUT_APP_SECRET": "<YOUR_HELPSCOUT_APP_SECRET>",
"HELPSCOUT_DOCS_API_KEY": "optional-docs-api-key"
}
}
}
}