# zendesk-mcp-server

Connects an AI assistant to Zendesk for Help Center search, ticket work, and article editing. Useful when support tasks should stay in the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: fruggr
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/fruggr/zendesk-mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/zendesk-mcp-server

## What it does

This server gives an assistant access to Zendesk Support and Help Center. It can find relevant articles, open and update tickets, change priority or assignee, add public replies and internal notes, and summarize a ticket thread. Images attached to tickets can be passed to the client model for inspection.

Knowledge-base work includes creating, translating, and revising articles section by section under `h1`, `h2`, and `h3` headings. End users can submit requests, answer ticket replies, and track the request status through the Help Center flow. The server can run locally over stdio or as a private HTTP service.

Authentication uses OAuth 2.1 PKCE, with a separate Zendesk session for each user. Static API tokens and shared service accounts are not supported, so OAuth 2.1 PKCE is required for the connection.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ZENDESK_SUBDOMAIN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ZENDESK_SUBDOMAIN=<ZENDESK_SUBDOMAIN> --transport stdio zendesk-mcp-server -- npx -y @fruggr/zendesk-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add zendesk-mcp-server --env ZENDESK_SUBDOMAIN=<ZENDESK_SUBDOMAIN> -- npx -y @fruggr/zendesk-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zendesk-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@fruggr/zendesk-mcp-server"
            ],
            "env": {
                "ZENDESK_SUBDOMAIN": "<ZENDESK_SUBDOMAIN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "zendesk-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@fruggr/zendesk-mcp-server"
            ],
            "env": {
                "ZENDESK_SUBDOMAIN": "<ZENDESK_SUBDOMAIN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ZENDESK_SUBDOMAIN=<ZENDESK_SUBDOMAIN> zendesk-mcp-server npx -y @fruggr/zendesk-mcp-server
```
Replace <…> with your own values

## When to use it
- search Zendesk Help Center content
- open and update support tickets
- summarize a ticket conversation
- inspect an image attached to a ticket
- revise one section of a knowledge-base article

## Example prompts
- Find the Help Center article about requesting a software license.
- Open a Zendesk ticket for a billing problem and add an internal note.
- Show my open billing tickets and summarize each one.

## Similar
- [zendesk-mcp](https://affpapa.org/en/nevibecode/mcp/zendesk-mcp.md) — MCP server · ★ 7
- [Zendesk Automation](https://affpapa.org/en/nevibecode/skills/zendesk-automation.md) — skill · 4600 installs
- [customer-support](https://affpapa.org/en/nevibecode/agents/customer-support.md) — subagent · 1041 installs
- [better-auth-security-best-practices](https://affpapa.org/en/nevibecode/skills/better-auth-security-best-practices.md) — skill · 48000 installs
- [extension-posting-to-x](https://affpapa.org/en/nevibecode/skills/extension-posting-to-x.md) — skill · 28100 installs
- [neon-auth](https://affpapa.org/en/nevibecode/skills/neon-auth.md) — skill · 20300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md