MCP server exposing the full Gorgias helpdesk API to AI assistants
If you already use Gorgias, the gorgias mcp server is the piece that lets your assistant work with it directly. MCP server exposing the full Gorgias helpdesk API to AI assistants.
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.
gorgias-mcp-server on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
gorgias_smart_search — Multi-strategy ticket search. Auto-detects emails, ticket IDs (#12345), customer names, view names, and topic keywords. Falls back throughgorgias_smart_get_ticket — Retrieves a ticket with its full conversation thread. Fetches ticket and messages in parallel, sorts chronologically, and projects to a compactgorgias_smart_stats — Analytics with automatic defaults, input validation, dimension resolution, and agent name-to-ID resolution. Covers volume, performance, qualityCategory — CountTickets — 13Customers — 12Messages — 6Tags — 7Views — 7Reporting — 1Users — 5Teams — 5Configuration is passed through the environment: GORGIAS_DOMAIN, GORGIAS_EMAIL, GORGIAS_API_KEY, GORGIAS_ACCESS_LEVEL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Plenty of team communication servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Gorgias's toolset — gorgias_smart_search, gorgias_smart_get_ticket, gorgias_smart_stats and 11 more — is a fair guide to whether it matches your workflow. It is maintained by benpalmer1; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| gorgias_smart_search | Multi-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_ticket | Retrieves 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_stats | Analytics with automatic defaults, input validation, dimension resolution, and agent name-to-ID resolution. Covers volume, performance, quality, automation, voice, and breakdown scopes. |
| Category | Count |
| Tickets | 13 |
| Customers | 12 |
| Messages | 6 |
| Tags | 7 |
| Views | 7 |
| Reporting | 1 |
| Users | 5 |
| Teams | 5 |
| Rules | 6 |
| Macros | 7 |
{
"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.
| Variable | Description | Required |
|---|---|---|
| GORGIAS_DOMAIN | Configuration value read at startup. | Optional |
| GORGIAS_EMAIL | Configuration value read at startup. | Optional |
| GORGIAS_API_KEY | Credential the server authenticates with. | Yes |
| GORGIAS_ACCESS_LEVEL | Configuration value read at startup. | Optional |
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Inbox intelligence — search, read, draft and send Gmail through your assistant with OAuth auto-setup.
Read and write Jira, Confluence, Bitbucket, JSM and Compass from your AI client — with your own permissions.
Read and send Telegram messages through your assistant — chats, channels and history via the client API.
Enables Discord bot integration with Model Context Protocol (MCP) compatible applications like Claude Desktop.
Exposes REST APIs defined by OpenAPI specifications as Model Context Protocol (MCP) tools, facilitating seamless integration into MCP-based workflows.