AI-Act-CheckKalenderChangelog
Menü

Help-Scout-Postfächer und Konversationen durchsuchen

Help Scout MCP Server · MCP-Server von drewburchfield · MCP-Server

MCP-Server für Help Scout · lesen und schreiben und senden · MIT · lokal (stdio)

Versendet und führt Befehle ausWas der Baustein im Konto darf

Gibt dem Assistenten Zugriff auf Help-Scout-Postfächer, Konversationen, Kunden, Organisationen und die Docs-Wissensdatenbank. Schreibende Aktionen sind standardmäßig aus.

Eigenes Profil aus den Quellen des Servers, Stand 05.10.2026 · Beleg 12

Was der Server kann

  • Konversationen nach Stichwort, Zeitraum, Status, Tag, E-Mail-Domain oder Ticketnummer suchen.
  • Kunden und Organisationen suchen und deren Konversationen abrufen.
  • Vollständige Threads, Zusammenfassungen und Rohdaten einer Konversation lesen.
  • Artikel der Help-Scout-Docs-Wissensdatenbank suchen und abrufen.
  • Help-Scout-Berichte und Metadaten abrufen.
  • Optional Entwürfe, interne Notizen, Tags, Status und Zuweisungen schreiben, wenn der Betreiber es einschaltet.

Einsatz in Marketing und Vertrieb

Vertrieb
Vor einem Kundentermin lädt der Assistent mit searchConversations alle Tickets einer E-Mail-Domain mit dem Tag urgent und fasst die offenen Themen zusammen.
Content
Der Assistent sucht per searchDocsArticles Artikel zu Rückerstattungen und vergleicht sie mit häufigen Kundenfragen aus den Konversationen.

Einrichtung

  1. In Help Scout unter My Apps eine private App anlegen und App ID sowie App Secret kopieren.
  2. Claude Desktop: die `.mcpb`-Datei aus den Releases installieren und die Zugangsdaten in den Einstellungen eintragen.
  3. Claude Code: `claude mcp add helpscout` mit den Variablen `HELPSCOUT_APP_ID` und `HELPSCOUT_APP_SECRET` und dem Start über `npx -y help-scout-mcp-server`.
  4. Für das Docs-Wissensdatenbank-Werkzeug zusätzlich `HELPSCOUT_DOCS_API_KEY` setzen.

Grenzen

  • Löschen und administrative Konfiguration sind laut README unter keinem Schalter vorgesehen.
  • Nachrichtentexte sind standardmäßig enthalten; REDACT_MESSAGE_CONTENT=true ersetzt sie, ist aber laut README keine Compliance-Garantie.
  • Persönliche Zugriffstoken werden nicht unterstützt.

Einordnung der Redaktion

Aufgaben: Kunden unterstützen. Für Marketing und Vertrieb gedacht.

Eigene Einordnung aus Name und Beschreibung des Anbieters, ohne technische Prüfung. Maßgeblich ist der Text des Anbieters darunter.

Beschreibung des Anbieters

Search Help Scout conversations, customers, organizations, threads, and inboxes with AI assistants

Eckdaten

—: Angabe nicht belegt.

Maintainer
drewburchfield
Repository-Lizenz
MIT
Letzter Repository-Commit

Commit innerhalb 90 Tagen

Dienstanbieter
Offizielle Dienstherkunft nicht belegt
Dienste
Help Scout
Bereiche
Vertrieb, Kommunikation
Plattformen
—
Version
1.7.0
Release
v2.1.0
Clients
Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf, Gemini CLI, Continue, OpenCode
Repository-Themen
customer-support, help-scout, helpscout, mcp, model-context-protocol, nodejs, typescript, mcp-server, modelcontextprotocol, help-scout-api

Werkzeuge

search_help_scout

Findet passende Operationen anhand einer Absicht, etwa Kundenverlauf oder Happiness-Bericht.

describe_help_scout

Lädt die vollständigen Eingabeschemas der gewählten Operationen.

read_help_scout

Führt eine Leseoperation aus, zum Beispiel getThreads oder searchConversations.

write_help_scout

Erscheint nur bei aktivierten Schreibrechten und führt Schreiboperationen aus.

get_tool_schema
Return the full input schemas for selected Help Scout read operations. Angabe des Anbieters · Beleg 5
call_tool
Execute one selected Help Scout read operation using arguments that match its loaded schema. Angabe des Anbieters · Beleg 5
searchConversations
Search and list conversations.… Angabe des Anbieters · Beleg 6
getConversation
Get the raw Help Scout conversation object by ID. Optionally embeds threads for direct API parity; use getThreads when full thread pagination is needed.… Angabe des Anbieters · Beleg 6
getConversationSummary
Get conversation summary with first customer message and latest staff reply Angabe des Anbieters · Beleg 6
getThreads
Retrieve full message history for a conversation. Returns all thread messages. Set includeSystemActors to distinguish user, team, and system_user person types. Angabe des Anbieters · Beleg 6
getServerTime
Get the current MCP host timestamp. Use before date-relative searches to calculate time ranges. Angabe des Anbieters · Beleg 6
listAllInboxes
List all inboxes with IDs. Pass nameContains to filter by a case-insensitive name substring. Deprecated: inbox IDs now in server instructions. Only needed mid-session. Angabe des Anbieters · Beleg 6
getInbox
Get one Help Scout inbox by ID, including inbox email and resource links.… Angabe des Anbieters · Beleg 6
getCustomer
Get a customer profile by ID. Returns profile with contact details (emails, phones, chat handles, social profiles, websites) plus address from a separate lookup. Angabe des Anbieters · Beleg 6
listCustomers
List or search customers by name, query syntax, or dates. Defaults to v2 page-based pagination.… Angabe des Anbieters · Beleg 6
searchCustomersByEmail
Search customers by email address using the v3 API. Provides email as a dedicated filter parameter (vs query syntax in v2) and cursor-based pagination. Angabe des Anbieters · Beleg 6
getCustomerContacts
Get all contact details for a customer: emails, phones, chat handles, social profiles, websites, and address. Calls dedicated sub-resource endpoints for complete data.… Angabe des Anbieters · Beleg 6
getOrganization
Get an organization by ID with optional customer/conversation counts. Angabe des Anbieters · Beleg 6
listOrganizations
List all organizations with sorting options. Use for discovering organizations before drilling into members or conversations. Returns 50 per page. Angabe des Anbieters · Beleg 6
getOrganizationMembers
Get all customers belonging to an organization. Use after getOrganization to see who is in the org. Returns 50 per page. Angabe des Anbieters · Beleg 6
getOrganizationConversations
Get all conversations associated with an organization. Traverses org-to-conversations without needing individual customer lookups. Returns 50 per page. Angabe des Anbieters · Beleg 6
listCustomerProperties
List customer property definitions. Use to interpret custom property values embedded on customer records. Angabe des Anbieters · Beleg 6
listOrganizationProperties
List organization property definitions. Use to interpret custom company property values embedded on organizations. Angabe des Anbieters · Beleg 6
getOrganizationProperty
Get one organization property definition by slug. Use after listOrganizationProperties when exact option labels are needed. Angabe des Anbieters · Beleg 6
listTags
List Help Scout tags used across inboxes. Use to discover tag IDs and exact names before filtering conversations or reports. Angabe des Anbieters · Beleg 6
getTag
Get a Help Scout tag by ID. Use after listTags when an exact tag record is needed. Angabe des Anbieters · Beleg 6
listUsers
List Help Scout users with optional exact email or inbox filter. Use to discover assignee IDs, mentions, and roles.… Angabe des Anbieters · Beleg 6
getUser
Get a Help Scout user by ID, or pass "me" to get the authenticated resource owner.… Angabe des Anbieters · Beleg 6
listTeams
List Help Scout teams. Use to discover team IDs before team-member lookup or team-scoped reporting. Angabe des Anbieters · Beleg 6
getTeamMembers
List members of a Help Scout team. Use after listTeams to discover user IDs in a team. Angabe des Anbieters · Beleg 6
listSavedReplies
List saved replies for a Help Scout inbox. Use to discover saved reply IDs and inspect reusable response templates. Angabe des Anbieters · Beleg 6
getSavedReply
Get one saved reply from a Help Scout inbox by ID. Angabe des Anbieters · Beleg 6
getOriginalSource
Get the original source for a Help Scout conversation thread. Set format to "rfc822" for raw email source, or "json" (default) for parsed source. Angabe des Anbieters · Beleg 6
getAttachment
Get base64-encoded Help Scout attachment data by conversation and attachment ID. Angabe des Anbieters · Beleg 6

Voraussetzungen

  • HELPSCOUT_APP_ID · Umgebungsvariable · erforderlich · Beleg 1
  • HELPSCOUT_APP_SECRET · Umgebungsvariable · erforderlich · Beleg 1
  • npx · Paketmanager · erforderlich · Beleg 1
  • HELPSCOUT_DEFAULT_INBOX_ID · Umgebungsvariable · optional · Beleg 7
  • HELPSCOUT_DOCS_API_KEY · Umgebungsvariable · optional · Beleg 7
  • REDACT_MESSAGE_CONTENT · Umgebungsvariable · optional · Beleg 7
7 Umgebungsvariablen laut Anbieter
  • CANDIDATE · Umgebungsvariable · Beleg 8
  • TRACE_FILE · Umgebungsvariable · Beleg 8
  • CANDIDATE_WRITES · Umgebungsvariable · Beleg 8
  • EVAL_MODELS · Umgebungsvariable · Beleg 9
  • EVAL_CANDIDATES · Umgebungsvariable · Beleg 9
  • EVAL_JOBS · Umgebungsvariable · Beleg 10
  • LOG_LEVEL · Umgebungsvariable · Beleg 11

Installation

npx -y help-scout-mcp-server@1.7.0

Rechte

Versendet und führt Befehle aus

Einordnung aus Werkzeugliste, Paketangaben und Paketinhalt, keine technische Prüfung · So entsteht die Ampel

  • 1 von 34 Werkzeugen kann Befehle ausführen, etwa call_tool.
  • 1 von 34 Werkzeugen legen Daten an oder ändern sie, etwa write_help_scout.
  • Der Anbieter deklariert: lesen, schreiben und senden.

Lass löschende, sendende und ausführende Werkzeuge nur nach Bestätigung je Aktion laufen und verbinde zuerst ein Testkonto.

App ID und App Secret einer privaten Help-Scout-App (OAuth2 Client Credentials); die App handelt mit den Rechten des Nutzers, der sie angelegt hat. Eine Standardinstallation ist lesend. Mit HELPSCOUT_ENABLE_WRITES=true kommen Entwürfe, Notizen, Tags, Status und Zuweisung hinzu. Erst mit HELPSCOUT_ENABLE_CUSTOMER_VISIBLE_WRITES=true und ausdrücklicher Bestätigung pro Aufruf lassen sich Antworten an Kunden senden.

Zugriffe laut Paketangaben
lesen, schreiben, senden
Authentifizierung
OAuth
Transport
stdio
Technische Prüfung
Ungeprüft
Paket und InstallationshinweiseRepository öffnen
Quellen (12)
  1. 1
  2. 2
  3. 3
  4. 4
  5. 5
  6. 6
  7. 7
  8. 8
  9. 9
  10. 10
  11. 11
  12. 12
  13. Abgerufen und Felder geprüft: 2026-10-05; technische Prüfung: ungeprüft
  14. Paketpfad: .

Verbundenes