You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
An [MCP server](https://modelcontextprotocol.io) that gives AI assistants direct access to your Help Scout inboxes, conversations, and threads. Search tickets, pull context, spot patterns, and get answers without leaving your editor or chat window.
5
+
An [MCP server](https://modelcontextprotocol.io) that gives AI assistants direct access to your Help Scout inboxes, conversations, customers, organizations, and threads. Search tickets, pull customer and account context, spot patterns, and get answers without leaving your editor or chat window.
6
6
7
7
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.
8
8
9
9
## What You Can Do
10
10
11
11
-**Search conversations** by keyword, date range, status, tag, email domain, or ticket number
12
+
-**Look up customers** by name, advanced query syntax, or exact email address
13
+
-**Explore organizations** with direct customer and conversation traversal
12
14
-**Pull full thread history** into context before drafting a reply
13
15
-**Get conversation summaries** with the original customer message and latest staff response
14
16
-**Monitor inbox activity** across multiple inboxes with a single query
@@ -74,7 +76,7 @@ docker run -e HELPSCOUT_APP_ID="your-app-id" \
74
76
## Getting Your API Credentials
75
77
76
78
1. Go to **Help Scout** > **My Apps** > **Create Private App**
77
-
2. Select at minimum: **Read** access to Mailboxesand Conversations
79
+
2. Select at minimum: **Read** access to Mailboxes, Conversations, Customers, and Organizations
78
80
3. Copy your **App ID** and **App Secret**
79
81
80
82
> Help Scout uses OAuth2 Client Credentials flow exclusively. Personal Access Tokens are not supported.
@@ -96,6 +98,14 @@ Alternative names `HELPSCOUT_CLIENT_ID` / `HELPSCOUT_CLIENT_SECRET` and legacy `
96
98
| Find by keyword |`comprehensiveConversationSearch`| "Find conversations about billing errors" |
97
99
| Look up a ticket number |`structuredConversationFilter`| "Show me ticket #42839" |
98
100
| Complex filters |`advancedConversationSearch`| "All @acme.com conversations tagged urgent" |
101
+
| Browse customers |`listCustomers`| "Show customers named Jane" |
102
+
| Find a customer by email |`searchCustomersByEmail`| "Find customer jane@acme.com" |
103
+
| Inspect a customer profile |`getCustomer`| "Open customer 12345" |
| Browse organizations |`listOrganizations`| "Show the busiest organizations" |
106
+
| Inspect an organization |`getOrganization`| "Open organization 456" |
107
+
| List customers in an organization |`getOrganizationMembers`| "Who belongs to organization 456?" |
108
+
| List organization conversations |`getOrganizationConversations`| "Show support history for organization 456" |
99
109
| Quick conversation overview |`getConversationSummary`| "Summarize this conversation" |
100
110
| Full message history |`getThreads`| "Show me the complete thread" |
101
111
| Current server time |`getServerTime`| Used for time-relative searches |
@@ -130,6 +140,7 @@ Works with any [MCP-compatible](https://modelcontextprotocol.io) client:
130
140
Built with compliance-minded teams in mind:
131
141
132
142
-**Optional PII redaction.** Message bodies are included by default. Set `REDACT_MESSAGE_CONTENT=true` to hide them for stricter compliance requirements.
143
+
-**Customer and organization redaction.** Customer contact fields and organization contact/location fields are also redacted when message-content redaction is enabled.
133
144
-**Secure authentication.** OAuth2 Client Credentials with automatic token refresh.
134
145
-**Rate limit handling.** Automatic retry with exponential backoff on 429 responses.
135
146
-**Scoped access.** Optional default inbox configuration limits what the AI can search.
Copy file name to clipboardExpand all lines: helpscout-mcp-extension/manifest.json
+36-4Lines changed: 36 additions & 4 deletions
Original file line number
Diff line number
Diff line change
@@ -2,9 +2,9 @@
2
2
"manifest_version": "0.3",
3
3
"name": "help-scout-mcp-server",
4
4
"display_name": "Help Scout MCP Server",
5
-
"version": "1.6.2",
6
-
"description": "Connect Claude and other AI assistants to your Help Scout data with enterprise-grade security and advanced search capabilities.",
7
-
"long_description": "Connect your AI assistant to Help Scout for intelligent customer support analysis.\n\n**Search & Analysis:**\n• Advanced conversation search with query syntax\n• Multi-status search across active, pending, and closed\n• Boolean queries with content and subject filtering\n• Conversation summaries and full thread retrieval\n• Direct ticket lookup by number\n\n**Enterprise Security:**\n• OAuth2 Client Credentials authentication\n• Optional content redaction for privacy\n• Built-in caching and rate limiting\n• Automatic retry with exponential backoff",
5
+
"version": "1.7.0",
6
+
"description": "Connect Claude and other AI assistants to your Help Scout conversations, customers, organizations, and inbox data.",
7
+
"long_description": "Connect your AI assistant to Help Scout for customer support investigation and account-level analysis.\n\n**Search & Analysis:**\n• Advanced conversation search with query syntax\n• Multi-status search across active, pending, and closed\n• Direct ticket lookup by number\n• Customer lookup by name, email, and organization\n• Organization-level customer and conversation traversal\n• Conversation summaries and full thread retrieval\n\n**Enterprise Security:**\n• OAuth2 Client Credentials authentication\n• Optional content redaction for privacy\n• Built-in caching and rate limiting\n• Automatic retry with exponential backoff",
8
8
"author": {
9
9
"name": "Drew Burchfield",
10
10
"url": "https://github.com/drewburchfield"
@@ -130,6 +130,38 @@
130
130
{
131
131
"name": "structuredConversationFilter",
132
132
"description": "Structural filtering by assignedTo, folderId, customerIds, conversationNumber, or advanced sorting - use after discovering IDs from content search"
133
+
},
134
+
{
135
+
"name": "getCustomer",
136
+
"description": "Get a customer profile by ID with embedded contact details and address lookup"
137
+
},
138
+
{
139
+
"name": "listCustomers",
140
+
"description": "List customers by name or advanced query syntax using the v2 Customers API"
141
+
},
142
+
{
143
+
"name": "searchCustomersByEmail",
144
+
"description": "Search customers by email address using the cursor-based v3 Customers API"
145
+
},
146
+
{
147
+
"name": "getCustomerContacts",
148
+
"description": "Fetch customer contact sub-resources including emails, phones, chats, websites, social profiles, and address"
149
+
},
150
+
{
151
+
"name": "getOrganization",
152
+
"description": "Get an organization profile by ID with optional counts and properties"
153
+
},
154
+
{
155
+
"name": "listOrganizations",
156
+
"description": "List organizations with Help Scout's supported sort modes"
157
+
},
158
+
{
159
+
"name": "getOrganizationMembers",
160
+
"description": "List customers associated with an organization"
161
+
},
162
+
{
163
+
"name": "getOrganizationConversations",
164
+
"description": "List conversations associated with an organization"
0 commit comments