Help Scout MCP Server
Help Scout inboxes, conversations, and Docs accessible via your AI assistant.
Data last scanned today · Reviewed today
Overview
This TypeScript-based MCP server provides direct AI integration with Help Scout. It allows users to search conversations, look up customer profiles, and retrieve Docs articles directly from their AI-enabled editor or chat interface. Beyond basic lookup, the server supports traversing organizations, inspecting detailed ticket metadata, and accessing internal platform reports. It is designed for Help Scout users looking to pull support context and productivity metrics into their workflow.
Our verdict
This server carries a high-risk score of 30/100. Because it is community-maintained rather than official, and lacks a read-only mode by default, users should exercise extreme caution regarding data access. It is best suited for experienced developers who can audit the source code before deployment, as it lacks OAuth support and has not been editorially reviewed.
- Active development with commits as recent as one day ago
- Small supply-chain footprint with only five direct dependencies
- Comprehensive support for Help Scout Docs and conversation metadata
- Features optional message redaction to reduce data payloads
- No read-only mode for restricted data access
- Lacks OAuth support for secure credential management
- Maintained by an individual contributor with high bus-factor risk
- Not an official integration from the Help Scout vendor
Setup
{
"mcpServers": {
"help-scout-mcp-server": {
"args": [
"-y",
"help-scout-mcp-server"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| search_help_scout | Find operations by intent (customer conversation history, happiness report). | low |
| describe_help_scout | Load the full input schemas for the operations you selected. | low |
| read_help_scout | Execute one operation. | low |
| write_help_scout | Execute write operations (draft replies, internal notes, status changes, assign/unassign, adding/removing tags, custom field values, snooze/unsnooze, moving conversation, sending replies, publishing drafts). | high |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What authentication method does this server use?
This server uses the Help Scout OAuth2 Client Credentials flow. You must create a private app within your Help Scout account settings to obtain the required App ID and App Secret.
›Are write operations enabled by default?
No, write actions such as drafting replies, adding notes, or updating ticket status are disabled by default. You must explicitly opt-in to enable the write surface in your settings.
›How do I access Help Scout Docs articles?
To use tools related to Docs, you must provide the HELPSCOUT_DOCS_API_KEY environment variable. This is separate from the primary App ID and App Secret used for the Mailbox API.
›Can I limit the data the server accesses?
Yes, the server supports optional message content redaction and scoped inbox access to reduce the volume of data returned in message payloads.
›What is the helpscout-navigator skill?
The helpscout-navigator is an optional plugin that teaches the AI how to effectively choose and use the appropriate tools for specific queries.
Badge
Maintain this server? Add the live badge to your README.