Help Scout MCP Server
by drewburchfieldcommunityv1.7.0
36
12
This MCP server provides AI assistants with direct access to Help Scout inboxes, allowing them to search tickets, pull customer context, and monitor conversations efficiently.
From the registry: Search Help Scout conversations, customers, organizations, threads, and inboxes with AI assistants
Install & configure
Prerequisites
- requiredHelp Scout private appCreate a private app in Help Scout My Apps with at least read access to Mailboxes, Conversations, Customers, and Organizationshttps://secure.helpscout.net/users/apps
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `help-scout-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Help Scout private app** — Create a private app in Help Scout My Apps with at least read access to Mailboxes, Conversations, Customers, and Organizations (https://secure.helpscout.net/users/apps)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["help-scout-mcp-server"]
- required environment variables:
- `HELPSCOUT_APP_ID`: Help Scout App ID (OAuth2 client ID) (example: `<your-helpscout-app-id>`)
- `HELPSCOUT_APP_SECRET`: Help Scout App Secret (example: `<your-helpscout-app-secret>`)
- optional environment variables:
- `HELPSCOUT_DEFAULT_INBOX_ID`: Scope searches to a specific inbox (example: `<your-inbox-id>`)
- `HELPSCOUT_BASE_URL`: Help Scout API endpoint (example: `https://api.helpscout.net/v2/`)
- `REDACT_MESSAGE_CONTENT`: Hide message bodies in responses (example: `false`)
- `CACHE_TTL_SECONDS`: Cache duration for API responses (example: `300`)
- `LOG_LEVEL`: Logging verbosity (example: `info`)
Note: Uses OAuth2 Client Credentials flow. Also available as a Docker image.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Uses OAuth2 Client Credentials flow. Also available as a Docker image.
Tools (15)
searchConversations
Lists recent tickets.
comprehensiveConversationSearch
Finds conversations by keyword.
structuredConversationFilter
Looks up a ticket number.
advancedConversationSearch
Applies complex filters to searches.
listCustomers
Browses customers.
searchCustomersByEmail
Finds a customer by email.
getCustomer
Inspects a customer profile.
getCustomerContacts
Pulls customer contact channels.
listOrganizations
Browses organizations.
getOrganization
Inspects an organization.
getOrganizationMembers
Lists customers in an organization.
getOrganizationConversations
Lists organization conversations.
getConversationSummary
Provides a quick overview of a conversation.
getThreads
Pulls full message history.
Environment variables
HELPSCOUT_APP_IDrequiredApp ID from Help Scout My Apps.HELPSCOUT_APP_SECRETrequiredApp Secret from Help Scout My Apps.Packages
help-scout-mcp-server
npmv1.7.0transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Mar 25, 2026
- Last commit
- Mar 31, 2026
- Registry name
- io.github.drewburchfield/help-scout-mcp