Gorgias MCP Server

MCP server exposing the full Gorgias helpdesk API to AI assistants

Local serverstdioTypeScript

What is the Gorgias MCP Server?

MCP server exposing the full Gorgias helpdesk API to AI assistants

What the server does

Gorgias MCP Server is a Model Context Protocol server that gives AI assistants -- Claude, and any other MCP-compatible client -- complete access to the Gorgias helpdesk platform. It ships with 112 tools: 3 high-level "smart" tools that handle the most common workflows, plus 109 raw API tools covering every Gorgias REST endpoint.

Credentials and setup notes

  • Node.js >= 20.0.0

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
gorgias_smart_searchMulti-strategy ticket search. Auto-detects emails, ticket IDs (#12345), customer names, view names, and topic keywords. Falls back through progressively broader search strategies to maximise result quality.
gorgias_smart_get_ticketRetrieves a ticket with its full conversation thread. Fetches ticket and messages in parallel, sorts chronologically, and projects to a compact format stripped to essential fields.
gorgias_smart_statsAnalytics with automatic defaults, input validation, dimension resolution, and agent name-to-ID resolution. Covers volume, performance, quality, automation, voice, and breakdown scopes.

How to install the Gorgias MCP Server

{
  "mcpServers": {
    "gorgias": {
      "command": "npx",
      "args": ["-y", "gorgias-mcp-server"],
      "env": {
        "GORGIAS_DOMAIN": "your-value",
        "GORGIAS_EMAIL": "your-value",
        "GORGIAS_API_KEY": "your-value",
        "GORGIAS_ACCESS_LEVEL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js >= 20.0.0
VariableDescriptionRequired
GORGIAS_DOMAINConfiguration value read at startup.Optional
GORGIAS_EMAILConfiguration value read at startup.Optional
GORGIAS_API_KEYCredential the server authenticates with.Yes
GORGIAS_ACCESS_LEVELConfiguration value read at startup.Optional

Example prompts to try

  • “Use Gorgias to gorgias smart search.”
  • “Use Gorgias to gorgias smart get ticket.”
  • “Use Gorgias to gorgias smart stats.”

Frequently asked questions

MCP server exposing the full Gorgias helpdesk API to AI assistants Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.