Skip to main content

Zendesk Guide MCP

Marla Sowards
Marla Sowards
Documentation Engineer

This is part of a series about custom MCP servers I've built to connect the systems I work in, so I can generate content from the information they hold, set up workflows that cover multiple tools, and eliminate manual, repetitive work that would otherwise only be possible through the application UI.

zendesk_guide_mcp.py

What it is​

This MCP server performs actions around Zendesk categories, sections, articles, labels, content tags, redirects, and themes. It is a wrapper around the Zendesk Help Center API, including both content management and theming.

Why I built it​

It's tedious and time consuming to work with Zendesk content by clicking around the Zendesk UI, and some features (like redirects) aren't even available there. AI agent skills using this MCP server allow me to use natural language prompts for things like:

  • Apply an export_data label to every article in the Export data section of the Data User Guide.
  • Remove callouts with Coming soon at the top of all articles with a sprint_201_release label.
  • List all articles that have no label, including their title and direct URL, and suggest labels.
  • List all unused labels and delete them with my approval.

For ultimate time savings, this MCP server can also be used in tandem with MCP servers for other enterprise tools (like Paligo CCMS) to perform multi-system actions like:

  • Publish the updated Data User Guide in Paligo to Zendesk and apply the Zendesk label extract_data to all new articles created in that guide in Paligo last week.
tip

See Zendesk Guide Pal for a sample of an AI agent skill that uses the Zendesk guide MCP server.

See my blog post, Build your own MCP server to hand off content management system tasks to an AI agent, for details on how I built the Zendesk Guide MCP server and wired it up with the Zendesk Guide Pal skill.