@wellforce/zendesk-mcp

A Zendesk MCP server for Claude Desktop. Gives Claude access to 41 Zendesk tools — manage tickets, users, organizations, and more through natural language.

Installation

Add to your Claude Desktop config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zendesk": {
      "command": "npx",
      "args": ["-y", "@wellforce/zendesk-mcp"],
      "env": {
        "ZENDESK_SUBDOMAIN": "yourcompany",
        "ZENDESK_EMAIL": "[email protected]",
        "ZENDESK_TOKEN": "your_api_token"
      }
    }
  }
}

Restart Claude Desktop. You should see a hammer icon with 41 tools available.

Getting Your API Token

1. Log into Zendesk as an admin
2. Go to Admin Center > Apps and Integrations > Zendesk API
3. Click Add API token
4. Copy the token — you won't be able to see it again

Environment Variables

| Variable | Description | Example | |----------|-------------|---------| | ZENDESK_SUBDOMAIN | Your Zendesk subdomain | acme (from acme.zendesk.com) | | ZENDESK_EMAIL | Your Zendesk agent email | [email protected] | | ZENDESK_TOKEN | Your Zendesk API token | See above |

Available Tools (41)

Tickets

• zendesk_list_tickets — List tickets with status/assignee/requester filters
• zendesk_get_ticket — Get a single ticket by ID
• zendesk_create_ticket — Create a new ticket
• zendesk_update_ticket — Update ticket properties
• zendesk_delete_ticket — Delete a ticket (soft delete)

Comments

• zendesk_list_comments — List all comments on a ticket
• zendesk_add_comment — Add a public reply or internal note

Users

• zendesk_list_users — List users with optional role filter
• zendesk_get_user — Get a user by ID
• zendesk_create_user — Create a new user
• zendesk_update_user — Update user properties
• zendesk_delete_user — Delete a user (soft delete)

Organizations

• zendesk_list_organizations — List all organizations
• zendesk_get_organization — Get an organization by ID
• zendesk_create_organization — Create a new organization
• zendesk_update_organization — Update organization properties
• zendesk_delete_organization — Delete an organization

Groups

• zendesk_list_groups — List all groups
• zendesk_get_group — Get a group by ID
• zendesk_create_group — Create a new group
• zendesk_update_group — Update group properties
• zendesk_delete_group — Delete a group

Views

• zendesk_list_views — List all views
• zendesk_get_view — Get a view by ID
• zendesk_list_view_tickets — List tickets in a view
• zendesk_count_view_tickets — Count tickets in a view

Macros

• zendesk_list_macros — List all macros
• zendesk_get_macro — Get a macro by ID
• zendesk_apply_macro — Apply a macro to a ticket

Triggers

• zendesk_list_triggers — List all triggers
• zendesk_get_trigger — Get a trigger by ID
• zendesk_create_trigger — Create a new trigger
• zendesk_update_trigger — Update trigger properties
• zendesk_delete_trigger — Delete a trigger

Automations

• zendesk_list_automations — List all automations
• zendesk_get_automation — Get an automation by ID
• zendesk_create_automation — Create a new automation
• zendesk_update_automation — Update automation properties
• zendesk_delete_automation — Delete an automation

Search

• zendesk_search — Search across tickets, users, and organizations

Auth

• zendesk_whoami — Check current authenticated identity

Development

git clone https://github.com/wellforce/zendesk-mcp.git
cd zendesk-mcp
npm install
npm run build
npm test

# Watch mode
npm run dev

# Test with MCP Inspector
npm run inspect

License

MIT