Helpscout CLI & MCP for AI agents & CI pipelines
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add hs-cli --env HS_INBOX_APP_ID='<HS_INBOX_APP_ID>' --env HS_INBOX_APP_SECRET='<HS_INBOX_APP_SECRET>' -- npx -y @operatorkit/hs mcp -t stdio~/.codex/config.toml
[mcp_servers.hs-cli]
command = "npx"
args = ["-y", "@operatorkit/hs", "mcp", "-t", "stdio"]
env = { HS_INBOX_APP_ID = "<HS_INBOX_APP_ID>", HS_INBOX_APP_SECRET = "<HS_INBOX_APP_SECRET>" }
# codex mcp add hs-cli --env HS_INBOX_APP_ID='<HS_INBOX_APP_ID>' --env HS_INBOX_APP_SECRET='<HS_INBOX_APP_SECRET>' -- npx -y @operatorkit/hs mcp -t stdio~/.cursor/mcp.json
{
"mcpServers": {
"hs-cli": {
"command": "npx",
"args": [
"-y",
"@operatorkit/hs",
"mcp",
"-t",
"stdio"
],
"env": {
"HS_INBOX_APP_ID": "<HS_INBOX_APP_ID>",
"HS_INBOX_APP_SECRET": "<HS_INBOX_APP_SECRET>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"hs-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@operatorkit/hs",
"mcp",
"-t",
"stdio"
],
"env": {
"HS_INBOX_APP_ID": "<HS_INBOX_APP_ID>",
"HS_INBOX_APP_SECRET": "<HS_INBOX_APP_SECRET>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"hs-cli": {
"command": "npx",
"args": [
"-y",
"@operatorkit/hs",
"mcp",
"-t",
"stdio"
],
"env": {
"HS_INBOX_APP_ID": "<HS_INBOX_APP_ID>",
"HS_INBOX_APP_SECRET": "<HS_INBOX_APP_SECRET>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"hs-cli": {
"command": "npx",
"args": [
"-y",
"@operatorkit/hs",
"mcp",
"-t",
"stdio"
],
"env": {
"HS_INBOX_APP_ID": "<HS_INBOX_APP_ID>",
"HS_INBOX_APP_SECRET": "<HS_INBOX_APP_SECRET>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"hs-cli": {
"command": "npx",
"args": [
"-y",
"@operatorkit/hs",
"mcp",
"-t",
"stdio"
],
"env": {
"HS_INBOX_APP_ID": "<HS_INBOX_APP_ID>",
"HS_INBOX_APP_SECRET": "<HS_INBOX_APP_SECRET>"
}
}
}
}Environment variables
HS_INBOX_APP_IDHS_INBOX_APP_SECRET
Replace the placeholders with your own credentials and keep them out of version control.