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 "Install 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 Scoutsearch 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.
MCP Help Scout
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.
Features
Docs API (v1)
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
Inbox API (v2)
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
Setup
Prerequisites
Node.js 18+
Help Scout API credentials (see below)
Installation
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 buildEnvironment Variables
Variable | 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.
VS Code MCP Configuration
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"
]
}
}
}Available Tools
Docs API Tools
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 |
Inbox API Tools
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 |
Authentication Details
Docs API
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
Inbox API
Uses OAuth 2.0 client credentials flow. The server automatically handles token acquisition and renewal.
Base URL: https://api.helpscout.net/v2
License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.