Zendesk — Claude Code MCP server: features and setup
Connect Zendesk Support to an agent to search tickets, inspect details, and make changes. Useful for triaging requests and preparing ticket follow-ups.
claude mcp add --env ZENDESK_CONFIG_PATH=<ZENDESK_CONFIG_PATH> --env ZENDESK_CLIENT_ID=<ZENDESK_CLIENT_ID> --env ZENDESK_CLIENT_SECRET=<ZENDESK_CLIENT_SECRET> --transport stdio zendesk -- npx -y @mindstone/mcp-server-zendeskWhat Zendesk does
The server gives an agent tools to search and export tickets, fetch individual records, create tickets, and change fields or comments. It can also search for users and connect a Zendesk account. Ticket search uses Zendesk query syntax; exports use cursor-based pagination and are not subject to the search tool’s 1000-result cap.
It runs over stdio with npx -y @mindstone/mcp-server-zendesk. Node.js 20+ and npm are required. For a standalone setup, set ZENDESK_CONFIG_PATH and create an accounts.json file with the Zendesk subdomain, email address, and API token; OAuth is supported too. Customer-written ticket text is treated as external content, not as directions for the agent, which matters when processing requests.
What it helps with
- find open, high-priority tickets
- fetch a ticket by its ID
- create a ticket or change its status
- add a comment to a ticket
- export tickets with cursor-based pagination
Example prompts for the agent
- Find open, high-priority Zendesk tickets and show the details of the first one.
- Fetch ticket
12345and summarize its latest details. - Create a Zendesk ticket and add this comment.
How to install Zendesk
Platform CLI
claude mcp add --env ZENDESK_CONFIG_PATH=<ZENDESK_CONFIG_PATH> --env ZENDESK_CLIENT_ID=<ZENDESK_CLIENT_ID> --env ZENDESK_CLIENT_SECRET=<ZENDESK_CLIENT_SECRET> --transport stdio zendesk -- npx -y @mindstone/mcp-server-zendeskReplace <…> with your own values
Platform CLI
codex mcp add zendesk --env ZENDESK_CONFIG_PATH=<ZENDESK_CONFIG_PATH> --env ZENDESK_CLIENT_ID=<ZENDESK_CLIENT_ID> --env ZENDESK_CLIENT_SECRET=<ZENDESK_CLIENT_SECRET> -- npx -y @mindstone/mcp-server-zendeskReplace <…> with your own values
Config file
{
"mcpServers": {
"zendesk": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-zendesk"
],
"env": {
"ZENDESK_CONFIG_PATH": "<ZENDESK_CONFIG_PATH>",
"ZENDESK_CLIENT_ID": "<ZENDESK_CLIENT_ID>",
"ZENDESK_CLIENT_SECRET": "<ZENDESK_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"zendesk": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-zendesk"
],
"env": {
"ZENDESK_CONFIG_PATH": "<ZENDESK_CONFIG_PATH>",
"ZENDESK_CLIENT_ID": "<ZENDESK_CLIENT_ID>",
"ZENDESK_CLIENT_SECRET": "<ZENDESK_CLIENT_SECRET>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ZENDESK_CONFIG_PATH=<ZENDESK_CONFIG_PATH> -e ZENDESK_CLIENT_ID=<ZENDESK_CLIENT_ID> -e ZENDESK_CLIENT_SECRET=<ZENDESK_CLIENT_SECRET> zendesk npx -y @mindstone/mcp-server-zendeskReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Zendesk
How do I install Zendesk in Claude Code?
Run claude mcp add mcp-server-zendesk -e ZENDESK_CLIENT_SECRET=<ZENDESK_CLIENT_SECRET> -- npx -y @mindstone/mcp-server-zendesk. Set the OAuth secret for this command.
What does the Zendesk MCP server do?
It connects Zendesk Support to an MCP host, letting an agent search, read, create, and update tickets. It also includes tools for account and user management.
What does the Zendesk MCP server need to run?
It requires Node.js 20+ and npm. A standalone account setup uses ZENDESK_CONFIG_PATH and an accounts.json file containing Zendesk account details.
