Skip to main content
Glama
helpscout-docs-mcp

helpscout-docs-mcp

by ryrykerr

helpscout-docs-mcp

MCP server for the Help Scout Docs API. Gives Claude access to your Help Scout knowledge base — collections, articles, and search.

Tools

Tool

Description

list_collections

List all knowledge-base collections (with article counts and visibility)

list_articles

List articles in a collection (metadata only — ID, name, status, URL, view count)

get_article

Fetch full article content by ID (HTML body, categories, related articles)

search_articles

Keyword search across articles (returns names, preview snippets, and IDs)

Related MCP server: Freshservice MCP Server

Setup

1. Get a Docs API key

In Help Scout, go to Manage → Docs → API Keys and generate a key.

2. Clone and install

git clone https://github.com/ryrykerr/helpscout-docs-mcp.git
cd helpscout-docs-mcp
npm install

3. Add to Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "helpscout-docs": {
      "command": "node",
      "args": ["/path/to/helpscout-docs-mcp/server.js"],
      "env": {
        "HELPSCOUT_DOCS_API_KEY": "your-docs-api-key"
      }
    }
  }
}

Replace /path/to/helpscout-docs-mcp/ with the actual path and your-docs-api-key with your API key.

How it works

The server uses Basic Auth against the Help Scout Docs API v1 (https://docsapi.helpscout.net/v1). It communicates over stdio using the Model Context Protocol SDK.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      C
      quality
      D
      maintenance
      Connects Claude to your Freshservice ITSM instance, enabling management of tickets, changes, assets, knowledge base, and more through natural language.
      70
      1
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to search, create, and update contacts, deals, and support tickets in HubSpot, and to generate cross-object account summaries.
      10
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables Claude to read and analyze Zendesk tickets, full conversations, and Help Center content, and to export large ticket sets, with read-only mode and optional write operations.
      53
      1
      MIT