Zendesk MCP Server

What is Zendesk MCP Server?

A Model Context Protocol (MCP) server that provides AI assistants like Claude with seamless integration to Zendesk Support. It enables natural language interactions with Zendesk tickets, allowing users to search, create, update, and manage support tickets through conversational AI.

How to use Zendesk MCP Server?

Install globally with npm install -g zd-mcp-server or use npx zd-mcp-server without installation. Set three environment variables: ZENDESK_EMAIL, ZENDESK_TOKEN, and ZENDESK_SUBDOMAIN. Configure the server in your MCP client (e.g., Claude Desktop, Cursor IDE) by adding a zendesk entry to the mcpServers configuration with the appropriate command and environment variables.

Key features of Zendesk MCP Server

• Complete ticket management: create, read, update, and search
• Add public comments and private internal notes
• Advanced search using Zendesk’s query syntax
• Retrieve and manage linked incident tickets
• Manage ticket tags and metadata
• Secure authentication using Zendesk API tokens

Use cases of Zendesk MCP Server

• Search and manage support tickets via natural language
• Create and update tickets based on customer conversations
• Add public replies and internal notes to tickets
• Run complex queries combining status, priority, tags, and dates
• Chain commands for batch-like operations on groups of tickets

FAQ from Zendesk MCP Server

How do I authenticate the Zendesk MCP Server?

Generate an API token in your Zendesk Admin Center under Apps and integrations → APIs → Zendesk API. Set the token, your Zendesk email, and your subdomain as environment variables (ZENDESK_TOKEN, ZENDESK_EMAIL, ZENDESK_SUBDOMAIN).

What permissions are required for my Zendesk account?

Your Zendesk user must have at least an Agent role, ticket access permissions, and API access enabled.

What should I do if I get an "Authentication failed" error?

Verify your API token is correct and hasn’t expired, ensure your email matches your Zendesk account, and check that your subdomain is spelled correctly (without the .zendesk.com suffix).

How can I run the server in debug mode?

Enable debug logging by setting the environment variable DEBUG=zd-mcp-server:* before starting the server.

Where are the log files located?

For Claude Desktop, logs are in ~/Library/Logs/Claude/ (macOS) or %APPDATA%/Claude/logs/ (Windows). For Cursor, check the output panel. When running directly in a terminal, logs appear in real-time.