Help Scout MCP Server
Search Help Scout conversations, customers, organizations, threads, and inboxes with AI assistants
47 stars286 downloads/wk
Reviews
Write oneNobody has reviewed Help Scout MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Help Scout MCP Server tools (17, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
advancedConversationSearchFilter conversations by email domain, customer email, or multiple tags. Supports boolean logic for complex queries. For simple keyword search, use comprehensiveConversationSearch.
comprehensiveConversationSearchSearch conversation content by keywords. Searches subject and body across all statuses. Requires searchTerms parameter. For listing without keywords, use searchConversations.
getConversationSummaryGet conversation summary with first customer message and latest staff reply
getCustomerGet a customer profile by ID. Returns profile with contact details (emails, phones, chat handles, social profiles, websites) plus address from a separate lookup.
getCustomerContactsGet all contact details for a customer: emails, phones, chat handles, social profiles, websites, and address. Calls dedicated sub-resource endpoints for complete data. Use after getCustomer or listCustomers.
getOrganizationGet an organization by ID with optional customer/conversation counts.
getOrganizationConversationsGet all conversations associated with an organization. Traverses org-to-conversations without needing individual customer lookups. Returns 50 per page.
getOrganizationMembersGet all customers belonging to an organization. Use after getOrganization to see who is in the org. Returns 50 per page.
getServerTimeGet current server timestamp. Use before date-relative searches to calculate time ranges.
getThreadsRetrieve full message history for a conversation. Returns all thread messages.
listAllInboxesList all inboxes with IDs. Deprecated: inbox IDs now in server instructions. Only needed mid-session.
listCustomersList or search customers by name, query syntax, or modification date. Page-based pagination (v2 API).
listOrganizationsList all organizations with sorting options. Use for discovering organizations before drilling into members or conversations. Returns 50 per page.
searchConversationsList conversations by status, date range, inbox, or tags. Searches all statuses by default. For keyword content search, use comprehensiveConversationSearch.
searchCustomersByEmailwrite actionSearch customers by email address using the v3 API. Provides email as a dedicated filter parameter (vs query syntax in v2) and cursor-based pagination.
searchInboxesList or search inboxes by name. Deprecated: inbox IDs now in server instructions. Only needed to refresh list mid-session.
structuredConversationFilterLookup conversation by ticket number or filter by assignee/customer/folder IDs. Use after discovering IDs from other searches. For initial searches, use searchConversations or comprehensiveConversationSearch.
Public scan report
scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan27 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 58 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Install Help Scout MCP Server in Claude Code, Cursor or VS Code
Runs npx -y help-scout-mcp-server on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add help-scout-mcp -- npx -y help-scout-mcp-server
What the publisher says
From the Help Scout MCP Server repository's README, as published. We do not edit it. Read it on GitHub
An MCP server that gives AI assistants direct access to your Help Scout inboxes, conversations, customers, organizations, threads, and Docs knowledge base. Search tickets, pull customer and account context, inspect articles, spot patterns, and get answers without leaving your editor or chat window.
Built by a Help Scout customer who wanted to give his support team superpowers. If you handle customer conversations in Help Scout and want AI to help you work faster, this is for you.
What You Can Do
- Search conversations by keyword, date range, status, tag, email domain, or ticket number
- Look up customers by name, advanced query syntax, or exact email address
- Explore organizations with direct customer and conversation traversal
- Inspect conversation detail with raw ticket metadata, summaries, full threads, attachments, and original source
- Pull full thread history into context before drafting a reply
- Get conversation summaries with the original customer message and latest staff response
- Search and retrieve Docs articles from the separate Help Scout Docs API
- Pull Help Scout reports and metadata for company, conversations, Docs, channels, productivity, happiness, users, teams, system users, statuses, routing, and webhooks
- Monitor inbox activity across multiple inboxes with a single query
- Take action with opt-in writes: draft replies, internal notes, tags, status, assignment, snooze, and more, all off by default
- Reduce message payloads with optional message content redaction and scoped inbox access
Quick Start
Claude Desktop & Claude Cowork (Recommended)
One-click install using Desktop Extensions. One install covers both Chat and Cowork sessions in the Claude desktop app.
- Download the latest .mcpb file from releases
- Double-click to install (or drag into Claude Desktop)
- Enter your Help Scout App ID and App Secret in the extension settings; the settings also carry toggles for message redaction and the opt-in write surface
- Restart Claude Desktop
If the tools don't show up in a Cowork session, update the desktop app to the latest version and start a fresh session. (Cowork walkthrough)
Optional: add the helpscout-navigator skill so Claude picks the right operation faster. Go to Customize, click + > Add marketplace from GitHub, enter drewburchfield/help-scout-mcp-server, and install helpscout-navigator.
Claude Code
Register the server, then optionally add the helpscout-navigator skill, which teaches Claude to pick the right operation for each query.
claude mcp add helpscout \
--env HELPSCOUT_APP_ID=your-app-id \
--env HELPSCOUT_APP_SECRET=your-app-secret \
-- npx -y help-scout-mcp-serverThen, for the navigation skill:
- Run /plugin marketplace add drewburchfield/help-scout-mcp-server
- Run /plugin install helpscout-navigator
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Help Scout MCP Server: common questions
- Is Help Scout MCP Server safe?
- Mostly: it is graded B (78/100). Read the Help Scout MCP Server safety report
- How do I install Help Scout MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Help Scout MCP Server need an API key?
- Yes. The registry entry asks for
HELPSCOUT_APP_ID,HELPSCOUT_APP_SECRET. - Is Help Scout MCP Server maintained?
- The last commit was 58 days ago (2026-08-01). The latest release is v1.7.0.
- What can I use instead of Help Scout MCP Server?
- Servers from other publishers that do the same job: ThoughtDAG MCP server, Minutes MCP server and freeq MCP server. Compare all Help Scout MCP Server alternatives.
Alternatives to Help Scout MCP Server
Same job from other publishers: the closest match first, then the best rated.
- ThoughtDAGSearch local AI conversations by file or phrase and recall source turns. Four read-only tools.not reviewedEstablishedA
- MinutesThe private, owned conversation-memory layer for AI. Record, transcribe, and search every meeting.not reviewedEstablishedA
- freeqRead and verify freeq conversations: channels, history, search, signatures, pins.not reviewedGrowingA
- StackexchangeSearch Stack Exchange questions, fetch Q&A threads as markdown, look up tag FAQs and user profiles.not reviewedGrowingA