Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (zendesk-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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 ZENDESK_EMAIL=your-email@example.com
export ZENDESK_API_TOKEN=your-api-token

Getting an API Token

Log in to your Zendesk account
Go to Admin Center > Apps and Integrations > APIs > Zendesk API
Click "Add API token"
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": "your-email@example.com",
        "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