zendesk MCP Server

README

Zendesk MCP Server

A Model Context Protocol server for Zendesk.

This server provides a comprehensive integration with Zendesk. It offers:

Tools for retrieving and managing Zendesk tickets and comments
Specialized prompts for ticket analysis and response drafting
Full access to the Zendesk Help Center articles as knowledge base

demo

Setup

build: uv venv && uv pip install -e . or uv build in short.
setup zendesk credentials in .env file, refer to .env.example.
configure in Claude desktop:

{
  "mcpServers": {
      "zendesk": {
          "command": "uv",
          "args": [
              "--directory",
              "/path/to/zendesk-mcp-server",
              "run",
              "zendesk"
          ]
      }
  }
}

Docker

You can containerize the server if you prefer an isolated runtime:

Copy .env.example to .env and fill in your Zendesk credentials. Keep this file outside version control.
Build the image:
```
docker build -t zendesk-mcp-server .
```
Run the server, providing the environment file:
```
docker run --rm --env-file /path/to/.env zendesk-mcp-server
```
Add -i when wiring the container to MCP clients over STDIN/STDOUT (Claude Code uses this mode). For daemonized runs, add -d --name zendesk-mcp.

The image installs dependencies from requirements.lock, drops privileges to a non-root user, and expects configuration exclusively via environment variables.

zendesk-mcp-server FAQ

Do I need an account or key?

Yes, three details: your Zendesk address, the email of an agent account, and a token you generate in Zendesk's admin settings. They sit in a file on your machine rather than being typed into the chat.

Can I use this to reply to a customer?

Yes, and this is the part to be careful with. Replies go out as public by default, so the customer sees them, and nothing asks you to confirm first. Say explicitly when you want an internal note.

Can it delete tickets?

No. There is no delete command anywhere in it. It can create tickets, comment on them and change their fields, but nothing removes one.

Is there a read-only mode?

No. Once it is connected, the writing commands are available too. If you want reading only, connect it using a Zendesk account whose permissions are restricted.

Is anything risky about changing tags?

Yes. Setting tags rewrites the ticket's whole tag list rather than adding to it, so a loosely worded request can quietly drop tags that were already there.

Which apps does it work with?

Claude Desktop and Claude Code are the documented ones, either by running the downloaded code directly or through a container you build. Anything that accepts a standard MCP entry will work.

How hard is the setup?

You will need a terminal. There is no ready-made package to point at — you download the code and build it, or build a container image, then add a few lines to your assistant's settings and a file holding your three Zendesk details.

Is it still maintained?

Yes, unusually so. Changes landed as recently as July 2026, though roughly seventeen issues are open, so it is worth a glance at those before you lean on it.

What does the help center connection do?

It pulls every published article once an hour and offers them as reference material, which is handy for drafting answers but slow to load on a large help center.

Is there a command the instructions leave out?

Yes. The code also includes a command for downloading a ticket attachment, which the written tool list on the project page does not mention.

zendesk-mcp-server

Use This MCP server To

README