Zendesk MCP Server
The Zendesk MCP Server is a tool for integrating with Zendesk to manage and interact with tickets through these functions:
Retrieve Tickets: Get tickets by ID and view detailed information including comments
Search Tickets: Find tickets using Zendesk query syntax
Create Tickets: Generate new Zendesk tickets
Update Tickets: Modify properties like status, priority, subject, tags, type, and assignee
Add Notes: Include private internal notes or public comments to tickets
Manage Linked Incidents: Retrieve all incident tickets linked to a particular ticket
Provides tools for retrieving, searching, creating, and updating Zendesk tickets, as well as adding public and private notes to tickets through Zendesk's API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Zendesk MCP Server show me all high priority tickets from today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Zendesk MCP Server
A Model Context Protocol (MCP) server that provides AI assistants like Claude with seamless integration to Zendesk Support. Enables natural language interactions with Zendesk tickets, allowing you to search, create, update, and manage support tickets through conversational AI.
β¨ Features
π« Complete Ticket Management: Create, read, update, and search Zendesk tickets
π¬ Comments & Notes: Add public comments and private internal notes
π Advanced Search: Search tickets using Zendesk's powerful query syntax
π Incident Management: Retrieve and manage linked incident tickets
π·οΈ Tag Management: Add and manage ticket tags and metadata
π Secure Authentication: Uses Zendesk API tokens for secure access
π Easy Installation: Available via npm, npx, or manual setup
Related MCP server: Zendesk MCP Server
π Quick Start
Option 1: NPM Installation (Recommended)
npm install -g zd-mcp-serverOption 2: Use with npx (No Installation)
npx zd-mcp-serverOption 3: Development Setup
git clone https://github.com/koundinya/zd-mcp-server.git
cd zd-mcp-server
npm install
npm run buildβοΈ Configuration
Environment Variables
Set these environment variables in your system or MCP client configuration:
export ZENDESK_EMAIL="your-email@company.com"
export ZENDESK_TOKEN="your-zendesk-api-token"
export ZENDESK_SUBDOMAIN="your-company" # from https://your-company.zendesk.comClaude Desktop Setup
Add to your Claude Desktop configuration file:
Location:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.json
Configuration:
{
"mcpServers": {
"zendesk": {
"command": "npx",
"args": ["-y", "zd-mcp-server"],
"env": {
"ZENDESK_EMAIL": "your-email@company.com",
"ZENDESK_TOKEN": "your-zendesk-api-token",
"ZENDESK_SUBDOMAIN": "your-company"
}
}
}
}Alternative (if installed globally):
{
"mcpServers": {
"zendesk": {
"command": "zd-mcp-server",
"env": {
"ZENDESK_EMAIL": "your-email@company.com",
"ZENDESK_TOKEN": "your-zendesk-api-token",
"ZENDESK_SUBDOMAIN": "your-company"
}
}
}
}Cursor IDE Setup
Add to ~/.cursor/mcp.json or .cursor/mcp.json in your project:
{
"mcpServers": {
"zendesk": {
"command": "npx",
"args": ["-y", "zd-mcp-server"],
"env": {
"ZENDESK_EMAIL": "your-email@company.com",
"ZENDESK_TOKEN": "your-zendesk-api-token",
"ZENDESK_SUBDOMAIN": "your-company"
}
}
}
}Other MCP Clients
For other MCP-compatible clients (Cline, Windsurf, etc.), refer to their documentation for MCP server configuration. The server supports standard MCP protocols.
π οΈ Available Tools
Tool | Description | Example Usage |
| Retrieve a ticket by ID | "Get ticket #12345" |
| Get detailed ticket with comments | "Show me full details for ticket #67890" |
| Search tickets with query syntax | "Find all urgent tickets from last week" |
| Create a new ticket | "Create a high priority ticket for login issues" |
| Update ticket properties | "Set ticket #555 to solved status" |
| Add internal agent notes | "Add a private note about investigation progress" |
| Add public customer comments | "Reply to customer with solution steps" |
| Get incident tickets linked to problems | "Show incidents related to this problem ticket" |
π¬ Usage Examples
Once configured, you can use natural language with your AI assistant:
Ticket Management
"Show me all high priority tickets assigned to me"
"Create a new ticket: Customer can't access dashboard, priority urgent"
"Update ticket #12345 status to pending and add a note about waiting for customer response"Search & Discovery
"Find all solved tickets from this week tagged with 'billing'"
"Search for open tickets containing 'password reset'"
"Show me tickets created by john@company.com in the last 30 days"Customer Communication
"Add a public comment to ticket #789: 'We've identified the issue and working on a fix'"
"Add a private note: 'Customer confirmed the workaround is effective'"Advanced Queries
"Find all problem tickets that have linked incidents"
"Show me escalated tickets that haven't been updated in 2 days"
"Get details for ticket #456 including all comments and history"π Authentication Setup
1. Generate API Token
Log in to your Zendesk account
Go to Admin Center β Apps and integrations β APIs β Zendesk API
Click Add API token
Add description: "MCP Server Integration"
Click Create and copy the token
Important: Save this token securely - you won't see it again
2. Find Your Subdomain
Your Zendesk URL format: https://YOUR-SUBDOMAIN.zendesk.com
Use YOUR-SUBDOMAIN as the ZENDESK_SUBDOMAIN value.
3. Required Permissions
Ensure your Zendesk user account has:
Agent role (minimum)
Ticket access permissions
API access enabled
π§ Development
Project Structure
zd-mcp-server/
βββ src/
β βββ index.ts # Server entry point
β βββ tools/
β βββ index.ts # Zendesk tool implementations
βββ dist/ # Compiled JavaScript
βββ package.json
βββ tsconfig.json
βββ README.mdBuilding from Source
git clone https://github.com/koundinya/zd-mcp-server.git
cd zd-mcp-server
npm install
npm run buildRunning Locally
# Start the server
npm start
# Development mode with auto-rebuild
npm run devTesting
# Test with MCP Inspector (if available)
npx @modelcontextprotocol/inspector zd-mcp-server
# Or test the built version
npx @modelcontextprotocol/inspector node dist/index.jsπ Troubleshooting
Common Issues
β "Authentication failed" errors
Verify your API token is correct and hasn't expired
Ensure your email address matches your Zendesk account
Check that your subdomain is spelled correctly (no
.zendesk.comsuffix)
β "Permission denied" errors
Verify your Zendesk user has Agent permissions or higher
Ensure API access is enabled for your account
Check if your token has the required scopes
β "Server not found" errors
Ensure you've installed the package:
npm install -g zd-mcp-serverTry using npx instead:
npx zd-mcp-serverCheck that your MCP client configuration file syntax is correct
β "Environment variables not set" errors
Verify all three environment variables are set:
ZENDESK_EMAIL,ZENDESK_TOKEN,ZENDESK_SUBDOMAINRestart your MCP client after setting environment variables
Check for typos in environment variable names
Debug Mode
Enable debug logging:
DEBUG=zd-mcp-server:* zd-mcp-serverLog Files
Check MCP client logs:
Claude Desktop:
~/Library/Logs/Claude/(macOS) or%APPDATA%/Claude/logs/(Windows)Cursor: Check the output panel for MCP server logs
Terminal: Run server directly to see real-time logs
π Advanced Usage
Search Query Syntax
Zendesk search supports powerful query operators:
# Status-based searches
status:open status:pending status:solved
# Priority searches
priority:urgent priority:high priority:normal priority:low
# Date-based searches
created>2024-01-01 updated<2024-01-31
# Tag searches
tags:billing tags:technical-issue
# Requester searches
requester:customer@company.com
# Complex combinations
status:open priority:high created>2024-01-01 tags:billingBatch Operations
While the server doesn't directly support batch operations, you can chain commands:
"Search for all urgent tickets, then show me details for the first 3 results"
"Find tickets tagged 'billing', update them to normal priority, and add a note about the billing system maintenance"π€ Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Development Setup
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
Reporting Issues
Found a bug? Please open an issue with:
Description of the problem
Steps to reproduce
Expected behavior
Your environment (OS, Node.js version, MCP client)
Relevant log outputs
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Links
Zendesk API Docs: https://developer.zendesk.com/api-reference/
Model Context Protocol: https://modelcontextprotocol.io/
π Support
Issues: GitHub Issues
Zendesk API: Zendesk Developer Documentation
MCP Protocol: MCP Documentation
Made with β€οΈ for the MCP and Zendesk communities
Available Tools
7 toolszendesk_add_private_noteC
Add a private internal note to a Zendesk ticket
Inputs: note (required), ticket_id (required).
zendesk_add_public_noteB
Add a public comment to a Zendesk ticket
Inputs: comment (required), ticket_id (required).
zendesk_create_ticketB
Create a new Zendesk ticket
Inputs: description (required), subject (required), priority, status, +2 more.
zendesk_get_ticketC
Get a Zendesk ticket by ID
Inputs: ticket_id (required).
zendesk_get_ticket_detailsC
Get detailed information about a Zendesk ticket including comments
Inputs: ticket_id (required).
zendesk_searchB
Search for Zendesk tickets based on a query
Inputs: query (required).
zendesk_update_ticketB
Update a Zendesk ticket's properties
Inputs: ticket_id (required), assignee_id, priority, status, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 7 tools
Most tools have distinct purposes, but there is notable overlap between 'zendesk_get_ticket' and 'zendesk_get_ticket_details'βboth retrieve ticket information, which could confuse agents about which to use for basic vs. detailed data. The other tools are clearly differentiated by their actions (create, update, search, add notes).
All tool names follow a consistent 'zendesk_verb_noun' pattern with snake_case, using clear verbs like 'add', 'create', 'get', 'search', and 'update'. This predictability makes it easy for agents to understand and navigate the toolset.
With 7 tools, the server is well-scoped for managing Zendesk tickets, covering core operations like create, read, update, search, and adding notes. This count is appropriate, avoiding bloat while providing essential functionality for the domain.
The toolset covers key CRUD and lifecycle aspects for Zendesk tickets, including creation, retrieval, updating, searching, and adding notes. A minor gap is the lack of a tool to delete tickets, but this is often intentional in support systems, and agents can work around it.
Related MCP Connectors
Connect Claude, ChatGPT or any AI assistant to Zendesk tickets, CSAT, macros and Help Center.
Zendesk MCP server for ChatGPT, Claude and any AI agent: list tickets, reply to ticket, update ticket, apply macro, add internal note and search tickets in your own Zendesk account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Zendesk yourself; Cotlet does not store your password and you need no Zendesk API key. About the official Zendesk API: Zendesk has a full REST API, the Support API (also called the Ticketing API), but no documented Zendesk-hosted MCP server for working tickets (checked 16 Oct 2026). Zendesk's MCP documentation covers the MCP client, where Zendesk calls other servers. Setup and FAQ: https://cotlet.dev/integrations/zendesk-api-mcp-server
Customer support for MCP servers: work your tickets from Claude or any MCP client. Service key auth.
Helpdesk tickets from your AI: find, reply, take, hold, complete β within your own role. OAuth.
Related MCP Servers
- AlicenseAqualityCmaintenanceThis server provides a comprehensive integration with Zendesk. Retrieving and managing tickets and comments. Ticket analyzes and response drafting. Access to help center articles as knowledge base.7126Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA lightweight, AI-native server that enables GPT-based AI agents to fetch real-time customer and organization context from Zendesk APIs dynamically.ISC
- FlicenseCqualityDmaintenanceA comprehensive server that allows users to interact with the Zendesk API, providing tools and resources for managing Zendesk Support, Talk, Chat, and Guide products including tickets, users, organizations, and more.4915 npm-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search tickets, manage tags, create tickets, inspect automations, and more in Zendesk.MIT