Zendesk MCP Server

List Tickets

Get a paginated list of all tickets in Zendesk. Returns tickets with their status, priority, subject, requester, assignee, and other core fields. Use cursor-based pagination for large result sets. Note: For incremental exports of all tickets, consider using the Incremental Export API instead.

Search Tickets

Search for tickets using Zendesk's powerful search query syntax. You can search by keywords, filter by status, priority, tags, dates, and more. Examples: 'printer' finds tickets with 'printer', 'status:open priority:high' finds open high-priority tickets, 'created>2024-01-01' finds recent tickets. Returns up to 1,000 results with pagination. Use this when you need to find specific tickets based on criteria.

Get Ticket

Retrieve detailed information about a specific ticket by its ID. Returns complete ticket data including status, priority, subject, description, requester, assignee, collaborators, tags, custom fields, and timestamps. Use this when you need full details about a known ticket.

Create Ticket

Create a new support ticket in Zendesk. You must provide a subject and description (as a comment). Optionally specify priority (urgent, high, normal, low), status (new, open, pending, hold, solved, closed), type (problem, incident, question, task), tags, assignee, and custom fields. The requester is typically the customer requesting support. Use this to create new support requests programmatically.

Update Ticket

Update an existing ticket's properties and optionally add a comment. You can modify status, priority, subject, assignee, tags, custom fields, and more. To add a comment to the ticket, include the comment_body parameter. Comments can be public (visible to end users) or private (agent-only). Use this to change ticket properties or add follow-up messages.

Delete Ticket

Permanently delete a ticket from Zendesk. This action cannot be undone. Use with caution. Tickets are typically solved or closed rather than deleted. Only use this for test tickets or spam. Requires appropriate permissions.

List Ticket Comments

Retrieve all comments (conversation history) for a specific ticket. Comments include messages from the requester, agents, and collaborators. Each comment shows the author, timestamp, body text, and whether it's public or private. Comments are ordered chronologically. Use this to review the full conversation history of a ticket.

Add Ticket Comment

Add a new comment to an existing ticket. This is an alternative to using Update Ticket for adding comments. You can specify whether the comment is public (visible to the requester) or private (agent-only internal note). Use this to respond to tickets or add internal notes.

List Users

Get a paginated list of all users in Zendesk. Users can be end users (customers), agents, or administrators. Filter by role to get specific user types. Returns user details including name, email, role, organization, and activity status. Use cursor-based pagination for large user lists.

Search Users

Search for users by query string. Searches across user name, email, phone, and other fields. Returns matching users with their details. Use this when you need to find specific users but don't have their ID. Example queries: email address, phone number, or partial name.

Get User

Retrieve detailed information about a specific user by their ID. Returns complete user profile including name, email, phone, role, organization, time zone, locale, tags, custom fields, and more. Use this to get full details about a known user.

Create User

Create a new user in Zendesk. You must provide a name and email. Optionally specify role (end-user, agent, admin), phone, organization, time zone, and other properties. By default, creates an end user (customer). Use this to add new customers or team members to Zendesk.

Update User

Update an existing user's properties. You can modify name, email, phone, role, organization, time zone, tags, and other fields. Use this to update user information or change user status (e.g., suspend a user).

List Organizations

Get a paginated list of all organizations in Zendesk. Organizations group end users together (e.g., by company or customer account). Returns organization details including name, domain names, notes, and custom fields. Use cursor-based pagination for large lists.

Get Organization

Retrieve detailed information about a specific organization by its ID. Returns complete organization data including name, domain names, notes, tags, custom fields, and associated users. Use this to get full details about a known organization.

Create Organization

Create a new organization in Zendesk. You must provide a name. Optionally specify domain names (for auto-assignment of users), notes, tags, and custom fields. Organizations help group related users together. Use this to add new customer companies or departments.

Update Organization

Update an existing organization's properties. You can modify name, domain names, notes, tags, and custom fields. Use this to update organization information or change organizational structure.

List Macros

Get a list of all macros available in Zendesk. Macros are pre-defined actions that agents can apply to tickets to quickly perform common tasks (e.g., responding to common questions, updating ticket properties). Returns macro titles, descriptions, and actions. Use this to discover available macros for automation.

List Triggers

Get a list of all triggers configured in Zendesk. Triggers are automatic actions that fire when tickets are created or updated, based on specified conditions (e.g., auto-assign tickets with certain tags, send notifications). Returns trigger titles, conditions, and actions. Use this to review automation rules.

List Automations

Get a list of all automations configured in Zendesk. Automations are time-based actions that run on tickets that meet certain conditions (e.g., close tickets after 7 days of being solved, escalate pending tickets after 24 hours). Returns automation titles, conditions, and actions. Use this to review time-based automation rules.

List Views

Get a list of all ticket views configured in Zendesk. Views are saved filters that display tickets matching specific criteria (e.g., 'My open tickets', 'Urgent tickets', 'Pending tickets'). Returns view titles, conditions, and availability. Use this to discover available views for organizing tickets.

List Groups

Get a list of all agent groups in Zendesk. Groups organize agents into teams (e.g., Sales Support, Technical Support, Billing). Tickets can be assigned to groups. Returns group names, descriptions, and member counts. Use this to discover available groups for ticket assignment.

Get Group

Retrieve detailed information about a specific group by its ID. Returns complete group data including name, description, member agents, and settings. Use this to get full details about a known group.

Add Tags to Ticket

Add one or more tags to a ticket. Tags are labels used to categorize and organize tickets (e.g., 'billing', 'bug', 'feature-request', 'urgent'). Tags can be used in triggers, automations, and views for filtering and routing. This operation adds tags without removing existing ones. Note: Cannot modify tags on closed tickets via this endpoint.

Remove Tags from Ticket

Remove one or more tags from a ticket. Specify the tags you want to remove; other tags remain unchanged. Use this to clean up or recategorize tickets. Note: Cannot modify tags on closed tickets via this endpoint.

Upload Attachment

Upload a file to Zendesk for later attachment to a ticket comment. This is step 1 of a 2-step process: first upload the file to get a token, then use that token when creating or updating a ticket with a comment. Returns an upload token that expires after a period of time. Supports files up to 50 MB. Use this when you need to attach files to tickets.

List Ticket Attachments

Get a list of all attachments associated with a specific ticket. Attachments are files that have been uploaded and attached to ticket comments. Returns attachment metadata including filename, size, content type, and download URL. Use this to discover what files have been shared in a ticket conversation.