zd

This MCP server provides a Zendesk integration for natural language interaction with Zendesk Support tickets. It exposes a suite of MCP tools to search, create, read, update, and comment on tickets, manage linked incidents, and handle tags and metadata. You can connect via MCP clients (Claude Desktop, Cursor, or any MCP-compatible client) using the provided configuration examples, typically by running the server through npx or a global installation. Once connected, you can issue natural language prompts like “Create a high priority ticket for login issues” or “Show me tickets with status open and tag billing” and the server will translate those requests into Zendesk API actions using its internal Zendesk tool implementations (e.g., zendesk_get_ticket, zendesk_search, zendesk_create_ticket, zendesk_update_ticket, zendesk_add_public_note, zendesk_add_private_note, zendesk_get_linked_incidents). In addition to basic ticket management, you can retrieve full ticket details with comments, perform advanced searches using Zendesk query syntax, and manage incidents and tags. The included usage examples illustrate common workflows such as creating tickets, updating statuses, and adding notes, making conversational AI a practical interface for Zendesk operations.

Prerequisites:

• Node.js and npm installed on your system
• Access to the internet to install the package or use npx

Installation options:

Option A: Install globally via npm (recommended for quick start)

npm install -g zd-mcp-server

Option B: Run directly with npx (no local installation required)

npx zd-mcp-server

Option C: Clone and install from source (development setup)

git clone https://github.com/koundinya/zd-mcp-server.git
cd zd-mcp-server
npm install
npm run build

After installation, start the server (if not using npx):

npm start

Environment variable guidance (required for Zendesk access):

• ZENDESK_EMAIL: Your Zendesk account email
• ZENDESK_TOKEN: Zendesk API token
• ZENDESK_SUBDOMAIN: Your Zendesk subdomain (e.g., your-company)

Tips and notes:

• When using Claude Desktop or Cursor, configure the MCP server entry with the appropriate command (npx zd-mcp-server or global install) and provide the three Zendesk environment variables.
• Ensure your Zendesk API token has the necessary scopes (API access, ticket read/write as needed).
• If you encounter authentication or permission errors, verify that the email, token, and subdomain are correct and that the API token is active.
• For development, you can run in debug mode by prefixing the command with DEBUG=zd-mcp-server:* to surface verbose logs.
• If you move to a local install, you can reference the local dist/index.js in MCP client configurations to test without npm global installs.
• This MCP server supports the standard MCP protocol, so it should work with other MCP clients beyond the listed ones by configuring the same environment variables.