Help Scout MCP Server

Name: Help Scout MCP Server
Author: drewburchfield

drewburchfield

MCP server for Help Scout - search conversations, customers, organizations, reports, and Docs with AI agents, plus opt-in writes for drafting replies and triage

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add help-scout --env HELPSCOUT_APP_ID='<HELPSCOUT_APP_ID>' --env HELPSCOUT_APP_SECRET='<HELPSCOUT_APP_SECRET>' -- npx -y help-scout-mcp-server

~/.codex/config.toml

[mcp_servers.help-scout]
command = "npx"
args = ["-y", "help-scout-mcp-server"]
env = { HELPSCOUT_APP_ID = "<HELPSCOUT_APP_ID>", HELPSCOUT_APP_SECRET = "<HELPSCOUT_APP_SECRET>" }

# codex mcp add help-scout --env HELPSCOUT_APP_ID='<HELPSCOUT_APP_ID>' --env HELPSCOUT_APP_SECRET='<HELPSCOUT_APP_SECRET>' -- npx -y help-scout-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "help-scout": {
      "command": "npx",
      "args": [
        "-y",
        "help-scout-mcp-server"
      ],
      "env": {
        "HELPSCOUT_APP_ID": "<HELPSCOUT_APP_ID>",
        "HELPSCOUT_APP_SECRET": "<HELPSCOUT_APP_SECRET>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "help-scout": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "help-scout-mcp-server"
      ],
      "env": {
        "HELPSCOUT_APP_ID": "<HELPSCOUT_APP_ID>",
        "HELPSCOUT_APP_SECRET": "<HELPSCOUT_APP_SECRET>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "help-scout": {
      "command": "npx",
      "args": [
        "-y",
        "help-scout-mcp-server"
      ],
      "env": {
        "HELPSCOUT_APP_ID": "<HELPSCOUT_APP_ID>",
        "HELPSCOUT_APP_SECRET": "<HELPSCOUT_APP_SECRET>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "help-scout": {
      "command": "npx",
      "args": [
        "-y",
        "help-scout-mcp-server"
      ],
      "env": {
        "HELPSCOUT_APP_ID": "<HELPSCOUT_APP_ID>",
        "HELPSCOUT_APP_SECRET": "<HELPSCOUT_APP_SECRET>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "help-scout": {
      "command": "npx",
      "args": [
        "-y",
        "help-scout-mcp-server"
      ],
      "env": {
        "HELPSCOUT_APP_ID": "<HELPSCOUT_APP_ID>",
        "HELPSCOUT_APP_SECRET": "<HELPSCOUT_APP_SECRET>"
      }
    }
  }
}

Environment variables

HELPSCOUT_APP_ID
HELPSCOUT_APP_SECRET

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related