MCP Help Scout MCP Server

MCP Help Scout

A comprehensive Model Context Protocol (MCP) server for the full Help Scout API — covering both the Docs API and the Inbox API.

Most existing Help Scout MCPs only cover conversations/messages. This one provides complete coverage of Help Scout's knowledge base (Docs) in addition to inbox functionality.

Features

Docs API (v1)

Full CRUD operations for Help Scout's knowledge base:

• Sites — List, get, create, update, delete
• Collections — List, get, create, update, delete
• Categories — List, get, create, update, reorder, delete
• Articles — List, search, get, create, update, delete, drafts, revisions
• Redirects — List, get, create, update, delete

Inbox API (v2)

Core inbox operations:

• Conversations — List, get, create, delete
• Threads — List, reply, add notes
• Customers — List, get, create
• Mailboxes — List, get
• Users — List, get, get current user
• Tags — List

Setup

Prerequisites

• Node.js 18+
• Help Scout API credentials (see below)

Installation

npm install -g @solveitsimply/mcp-helpscout

Or clone and build locally:

git clone https://github.com/solveitsimply/mcp-helpscout.git
cd mcp-helpscout
npm install
npm run build

Environment Variables

You can use just the Docs API key, just the Inbox OAuth credentials, or both.

VS Code MCP Configuration

Add to .vscode/mcp.json:

{
  "servers": {
    "mcp-helpscout": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-helpscout/dist/index.js"],
      "env": {
        "HELPSCOUT_API_KEY": "your-docs-api-key",
        "HELPSCOUT_APP_ID": "your-app-id",
        "HELPSCOUT_APP_SECRET": "your-app-secret"
      }
    }
  }
}

Or using shell to read from .env.local:

{
  "servers": {
    "mcp-helpscout": {
      "type": "stdio",
      "command": "sh",
      "args": [
        "-c",
        "export $(grep -E '^HELPSCOUT_' /path/to/.env.local | xargs) && exec node /path/to/mcp-helpscout/dist/index.js"
      ]
    }
  }
}

Available Tools

Docs API Tools

Inbox API Tools

Authentication D