Provides comprehensive access to the Help Scout API, supporting both the Docs API for knowledge base management (sites, collections, articles, and redirects) and the Inbox API for communication management (conversations, threads, customers, mailboxes, and tags).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Help Scout search for articles about our troubleshooting steps"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A comprehensive Model Context Protocol (MCP) server for the full Help Scout API — covering both the Docs API and the Inbox API.
Most existing Help Scout MCPs only cover conversations/messages. This one provides complete coverage of Help Scout's knowledge base (Docs) in addition to inbox functionality.
Full CRUD operations for Help Scout's knowledge base:
Sites — List, get, create, update, delete
Collections — List, get, create, update, delete
Categories — List, get, create, update, reorder, delete
Articles — List, search, get, create, update, delete, drafts, revisions
Redirects — List, get, create, update, delete
Core inbox operations:
Conversations — List, get, create, delete
Threads — List, reply, add notes
Customers — List, get, create
Mailboxes — List, get
Users — List, get, get current user
Tags — List
Related MCP server: Zendesk API MCP Server
Node.js 18+
Help Scout API credentials (see below)
npm install -g @solveitsimply/mcp-helpscoutOr clone and build locally:
git clone https://github.com/solveitsimply/mcp-helpscout.git
cd mcp-helpscout
npm install
npm run buildVariable | Required For | Description |
| Docs API | API key from Help Scout → Profile → Authentication → API Keys |
| Inbox API | OAuth app ID from Help Scout → Manage → Apps → My Apps |
| Inbox API | OAuth app secret |
You can use just the Docs API key, just the Inbox OAuth credentials, or both.
Add to .vscode/mcp.json:
{
"servers": {
"mcp-helpscout": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-helpscout/dist/index.js"],
"env": {
"HELPSCOUT_API_KEY": "your-docs-api-key",
"HELPSCOUT_APP_ID": "your-app-id",
"HELPSCOUT_APP_SECRET": "your-app-secret"
}
}
}
}Or using shell to read from .env.local:
{
"servers": {
"mcp-helpscout": {
"type": "stdio",
"command": "sh",
"args": [
"-c",
"export $(grep -E '^HELPSCOUT_' /path/to/.env.local | xargs) && exec node /path/to/mcp-helpscout/dist/index.js"
]
}
}
}Tool | Description |
| List all Docs sites |
| Get a site by ID |
| Create a new site |
| Update a site |
| Delete a site |
| List collections (filter by site, visibility) |
| Get a collection by ID |
| Create a collection |
| Update a collection |
| Delete a collection |
| List categories in a collection |
| Get a category by ID |
| Create a category |
| Update a category |
| Reorder categories |
| Delete a category |
| List articles in a collection or category |
| Search articles by query |
| Get full article with content |
| Create an article |
| Update an article |
| Delete an article |
| List related articles |
| List article revisions |
| Get a specific revision |
| Save an article draft |
| Delete an article draft |
| List URL redirects for a site |
| Get a redirect by ID |
| Create a redirect |
| Update a redirect |
| Delete a redirect |
Tool | Description |
| List conversations (filter by mailbox, status, tag) |
| Get conversation details |
| Create a new conversation |
| Delete a conversation |
| List threads in a conversation |
| Send a reply in a conversation |
| Add an internal note |
| List/search customers |
| Get customer details |
| Create a customer |
| List mailboxes |
| Get mailbox details |
| List team members |
| Get user details |
| Get authenticated user |
| List all tags |
Uses HTTP Basic Authentication with the API key as the username and X as the password. The API key is associated with a Help Scout user account.
Base URL: https://docsapi.helpscout.net/v1
Uses OAuth 2.0 client credentials flow. The server automatically handles token acquisition and renewal.
Base URL: https://api.helpscout.net/v2
MIT
This server cannot be deployed
MCP server for smoothsend documentation, generated by doc2mcp.
Remote MCP server for managing Muninx tickets, messages, ticket search, and support analytics.
AI customer support MCP server for ClerkChat. Manage your customer service chatbot and support inbox from Claude, ChatGPT or Cursor. - Build AI support agents and train their knowledge base on your website, help center, PDFs, Google Docs, Notion pages and YouTube videos - Answer customers on WhatsApp, Instagram DMs, Facebook Messenger, Telegram, live chat widget and a hosted help page - Work the shared support inbox: read conversations, draft and send replies, translate messages, take over from the AI, assign, prioritize and close tickets - Hand off to humans with escalations to Zendesk and Intercom, plus Slack alerts - Capture and export leads, run support automations, and track support analytics (conversation volume, containment rate, first response time) Hosted, with OAuth sign-in and per-workspace access. Works with Shopify and Stripe for order and billing questions.
