---
title: "Zendesk Integration"
description: "Manage Zendesk tickets, users, and help center content"
---
The Zendesk integration provides access to manage Zendesk tickets, users, and help center content through the Integrate MCP server.

## Installation

The Zendesk integration is included with the SDK:

```typescript
import { zendeskIntegration } from "integrate-sdk/server";
```

## Setup

### 1. Create a Zendesk OAuth App

1. Create an OAuth application for Zendesk
2. Configure your redirect URI
3. Note your Client ID and Client Secret

### 2. Configure the Integration on Your Server

Add the Zendesk integration to your server configuration. The integration automatically reads `ZENDESK_CLIENT_ID` and `ZENDESK_CLIENT_SECRET` from your environment variables:

```typescript
import { createMCPServer, zendeskIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    zendeskIntegration({
    }),
  ],
});
```

You can override the environment variables by passing explicit values:

```typescript
zendeskIntegration({
  clientId: process.env.CUSTOM_ZENDESK_ID,
  clientSecret: process.env.CUSTOM_ZENDESK_SECRET,
});
```

### 3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

```typescript
import { client } from "integrate-sdk";

await client.authorize("zendesk");
const result = await client.zendesk.listTickets({});

console.log(result);
```

If you're using a custom client, add the integration to the integrations array:

```typescript
import { createMCPClient, zendeskIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [zendeskIntegration()],
});
```

## Configuration Options

<AutoTypeTable
  path="../src/integrations/zendesk.ts"
  name="ZendeskIntegrationConfig"
/>


## Tools

### `zendesk_list_tickets`

List tickets

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskListTicketsParams"
/>

### `zendesk_get_ticket`

Get a specific ticket

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskGetTicketParams"
/>

### `zendesk_create_ticket`

Create a new ticket

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskCreateTicketParams"
/>

### `zendesk_update_ticket`

Update an existing ticket

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskUpdateTicketParams"
/>

### `zendesk_delete_ticket`

Delete a ticket

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskDeleteTicketParams"
/>

### `zendesk_add_comment`

Add a comment to a ticket

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskAddCommentParams"
/>

### `zendesk_list_ticket_comments`

List comments on a ticket

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskListTicketCommentsParams"
/>

### `zendesk_list_users`

List users

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskListUsersParams"
/>

### `zendesk_get_user`

Get a specific user

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskGetUserParams"
/>

### `zendesk_create_user`

Create a new user

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskCreateUserParams"
/>

### `zendesk_update_user`

Update an existing user

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskUpdateUserParams"
/>

### `zendesk_search_users`

Search for users

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskSearchUsersParams"
/>

### `zendesk_list_organizations`

List organizations

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskListOrganizationsParams"
/>

### `zendesk_get_organization`

Get a specific organization

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskGetOrganizationParams"
/>

### `zendesk_create_organization`

Create a new organization

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskCreateOrganizationParams"
/>

### `zendesk_update_organization`

Update an existing organization

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskUpdateOrganizationParams"
/>

### `zendesk_list_groups`

List groups

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskListGroupsParams"
/>

### `zendesk_get_group`

Get a specific group

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskGetGroupParams"
/>

### `zendesk_search_tickets`

Search for tickets

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskSearchTicketsParams"
/>

### `zendesk_search`

Search across all Zendesk resources (tickets, users, organizations)

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskSearchParams"
/>

### `zendesk_list_views`

List views

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskListViewsParams"
/>

### `zendesk_get_view_tickets`

Get tickets from a specific view

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskGetViewTicketsParams"
/>

### `zendesk_list_macros`

List macros

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskListMacrosParams"
/>

### `zendesk_list_tags`

List tags

_No parameters._

### `zendesk_add_tags`

Add tags to a ticket

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskAddTagsParams"
/>

### `zendesk_remove_tags`

Remove tags from a ticket

<AutoTypeTable
  path="generated/tool-params/zendesk.ts"
  name="ZendeskRemoveTagsParams"
/>

## Notes

- Category: Business
- Authentication mode: OAuth