---
asIndexPage: true
---

# Zendesk

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Enable agents to interact with Zendesk"
  author="Arcade"
  codeLink="https://github.com/ArcadeAI/arcade-ai/tree/main/resources/integrations/zendesk"
  authType="OAuth2"
  versions={["1.0.0"]}
/>

<Badges repo="arcadeai/arcade_zendesk" />

The Zendesk MCP Server provides a set of tools for managing customer support tickets and knowledge base articles. With this MCP Sever, users can:

- List and paginate through tickets in their Zendesk account.
- Retrieve all comments for specific tickets, including the original description and conversation history.
- Add comments to existing tickets to facilitate communication.
- Mark tickets as solved, optionally including a final comment.
- Search for published Help Center articles in the knowledge base, with support for multiple filters in a single request.

This MCP Sever streamlines the process of handling customer inquiries and accessing support resources.

## Available Tools

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    [
      "Zendesk.ListTickets",
      "List tickets from your Zendesk account with offset-based pagination.",
    ],
    [
      "Zendesk.GetTicketComments",
      "Get all comments for a specific Zendesk ticket, including the original description.",
    ],
    [
      "Zendesk.AddTicketComment",
      "Add a comment to an existing Zendesk ticket.",
    ],
    [
      "Zendesk.MarkTicketSolved",
      "Mark a Zendesk ticket as solved, optionally with a final comment.",
    ],
    [
      "Zendesk.SearchArticles",
      "Search for Help Center articles in your Zendesk knowledge base.",
    ],
    [
      "Zendesk.WhoAmI",
      "Get comprehensive user profile and Zendesk account information.",
    ],
  ]}
/>

<Callout>
  If you need to perform an action that's not listed here, you can [get in touch
  with us](mailto:contact@arcade.dev) to request a new tool, or [create your own
  tools](/guides/create-tools/tool-basics/build-mcp-server).
</Callout>

## Zendesk.ListTickets

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/zendesk/list_tickets_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/zendesk/list_tickets_example_call_tool.js",
        ],
      },
    },
  ]}
/>

List tickets from your Zendesk account with offset-based pagination.

**Parameters**

- **status** (`Enum` [TicketStatus](/resources/integrations/customer-support/zendesk/reference#TicketStatus), optional) The status of tickets to filter by. Defaults to 'open'
- **limit** (`integer`, optional) Number of tickets to return. Defaults to 30
- **offset** (`integer`, optional) Number of tickets to skip before returning results. Defaults to 0
- **sort_order** (`Enum` [SortOrder](/resources/integrations/customer-support/zendesk/reference#SortOrder), optional) Sort order for tickets by ID. 'asc' returns oldest first, 'desc' returns newest first. Defaults to 'desc'

**Secrets**

This tool requires the following secrets: `zendesk_subdomain` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))

## Zendesk.GetTicketComments

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/zendesk/get_ticket_comments_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/zendesk/get_ticket_comments_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Get all comments for a specific Zendesk ticket, including the original description.

**Parameters**

- **ticket_id** (`integer`, required) The ID of the ticket to get comments for

**Secrets**

This tool requires the following secrets: `zendesk_subdomain` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))

## Zendesk.AddTicketComment

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/zendesk/add_ticket_comment_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/zendesk/add_ticket_comment_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Add a comment to an existing Zendesk ticket.

**Parameters**

- **ticket_id** (`integer`, required) The ID of the ticket to comment on
- **comment_body** (`string`, required) The text of the comment
- **public** (`boolean`, optional) Whether the comment is public (visible to requester) or internal. Defaults to True

**Secrets**

This tool requires the following secrets: `zendesk_subdomain` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))

## Zendesk.MarkTicketSolved

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/zendesk/mark_ticket_solved_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/zendesk/mark_ticket_solved_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Mark a Zendesk ticket as solved, optionally with a final comment.

**Parameters**

- **ticket_id** (`integer`, required) The ID of the ticket to mark as solved
- **comment_body** (`string`, optional) Optional final comment to add when solving the ticket
- **comment_public** (`boolean`, optional) Whether the comment is visible to the requester. Defaults to False

**Secrets**

This tool requires the following secrets: `zendesk_subdomain` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))

## Zendesk.SearchArticles

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/zendesk/search_articles_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/zendesk/search_articles_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Search for Help Center articles in your Zendesk knowledge base.

**Parameters**

- **query** (`string`, optional) Search text to match against articles. Supports quoted expressions for exact matching
- **label_names** (`array[string]`, optional) List of label names to filter by (case-insensitive). Article must have at least one matching label. Available on Professional/Enterprise plans only
- **created_after** (`string`, optional) Filter articles created after this date (format: YYYY-MM-DD)
- **created_before** (`string`, optional) Filter articles created before this date (format: YYYY-MM-DD)
- **created_at** (`string`, optional) Filter articles created on this exact date (format: YYYY-MM-DD)
- **sort_by** (`Enum` [ArticleSortBy](/resources/integrations/customer-support/zendesk/reference#ArticleSortBy), optional) Field to sort articles by. Defaults to relevance according to the search query
- **sort_order** (`Enum` [SortOrder](/resources/integrations/customer-support/zendesk/reference#SortOrder), optional) Sort order direction. Defaults to descending
- **limit** (`integer`, optional) Number of articles to return. Defaults to 30
- **offset** (`integer`, optional) Number of articles to skip before returning results. Defaults to 0
- **include_body** (`boolean`, optional) Include article body content in results. Bodies will be cleaned of HTML and truncated
- **max_article_length** (`integer`, optional) Maximum length for article body content in characters. Set to None for no limit. Defaults to 500

**Secrets**

This tool requires the following secrets: `zendesk_subdomain` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))

## Zendesk.WhoAmI

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/zendesk/who_am_i_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/zendesk/who_am_i_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Get comprehensive user profile and Zendesk account information.

**Parameters**

This tool does not take any parameters.

**Secrets**

This tool requires the following secrets: `zendesk_subdomain` (learn how to [configure secrets](/guides/create-tools/tool-basics/create-tool-secrets))

<ToolFooter pipPackageName="arcade_zendesk" />