Zendesk MCP Server

A Model Context Protocol (MCP) server for integrating with Zendesk Ticketing and Help Center APIs.

Features

Ticketing (13 tools)

• list_tickets - List all tickets with pagination and sorting
• get_ticket - Get ticket details by ID
• create_ticket - Create a new ticket
• update_ticket - Update an existing ticket
• delete_ticket - Delete a ticket
• search_tickets - Search tickets using Zendesk query syntax
• list_ticket_comments - Get comments on a ticket
• add_ticket_comment - Add a comment to a ticket
• list_users - List all users
• get_user - Get user details
• create_user - Create a new user
• list_organizations - List organizations
• list_groups - List agent groups

Help Center (7 tools)

• list_articles - List Help Center articles
• get_article - Get article details
• create_article - Create a new article
• update_article - Update an article
• search_articles - Search articles
• list_sections - List sections
• list_categories - List categories

Installation

npm install zendesk-mcp

Or install globally:

npm install -g zendesk-mcp

Configuration

Set the following environment variables:

export ZENDESK_SUBDOMAIN=your-subdomain    # e.g., "yespark" for yespark.zendesk.com
export [email protected]
export ZENDESK_API_TOKEN=your-api-token

Getting an API Token

1. Log in to your Zendesk account
2. Go to Admin Center > Apps and Integrations > APIs > Zendesk API
3. Click "Add API token"
4. Copy the token (you won't be able to see it again)

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["zendesk-mcp"],
      "env": {
        "ZENDESK_SUBDOMAIN": "your-subdomain",
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_API_TOKEN": "your-api-token"
      }
    }
  }
}

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run watch

# Test with MCP Inspector
npm run inspector

Examples

Search open tickets

Search for all open tickets assigned to the support group

Create a ticket

Create a ticket with subject "Login issue" and description "User cannot log in"

List Help Center articles

List all articles in the FAQ section

License

MIT