Zammad Mcp Server

Name: Zammad Mcp Server
Author: Softoft-Orga

@Softoft-Orga

About Zammad Mcp Server

A production-ready Model Context Protocol (MCP) server for Zammad, the open-source helpdesk and ticket system. It gives Claude, Cursor, and other MCP clients structured access to tickets, users, organizations, groups, and system metadata with configurable access control.

#mcp #zammad #helpdesk #tickets #customer-support #ai-agents #claude #cursor #python #fastmcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "zammad": {
      "command": "uvx",
      "args": [
        "zammad-mcp-server"
      ],
      "env": {
        "ZAMMAD_URL": "https://your-zammad-instance.example.com",
        "ZAMMAD_HTTP_TOKEN": "your_api_token",
        "MCP_DENIED_TOOLS": "delete_ticket,delete_user,delete_organization"
      }
    }
  }
}

Tools

Check the health of the Zammad MCP Server and its connection to Zammad. Returns: Health status information including server status and connection details.

Get information about the Zammad server. Returns: Server version, configuration, and status information.

Get a list of all tools accessible to the current session. Returns: List of tools with their categories and permission levels.

Get a specific ticket by ID.

Search for tickets with various filters.

Create a new ticket.

Update an existing ticket.

Delete a ticket.

Get all articles (messages) for a ticket.

Add a new article to an existing ticket.

Get ticket statistics.

Get all available ticket states. Returns: List of available ticket states with their properties.

Get all available ticket priorities. Returns: List of available priority levels.

Get a user by ID.

Search for users.

Create a new user.

Update a user.

Delete a user.

Get the currently authenticated user. Returns: Current user details.

Get an organization by ID.

Search for organizations.

Create a new organization.

Update an organization.

Delete an organization.

Get a group by ID.

List all groups. Returns: List of all groups.

Overview

What is Zammad MCP Server?

The Zammad MCP Server is a production-ready Model Context Protocol (MCP) server for Zammad, the open-source helpdesk and ticket system. It gives AI assistants such as Claude structured, type-safe access to Zammad ticket management, users, organizations, groups, and system tools, enabling natural‑language helpdesk automation.

How to use Zammad MCP Server?

Install via pip (pip install zammad-mcp-server) or with uv/uvx. Create a .env file with ZAMMAD_URL and ZAMMAD_HTTP_TOKEN. Run as zammad-mcp-server (stdio transport) or with --transport sse for remote clients. Configure in Claude Desktop / Cursor by adding the command and environment variables to claude_desktop_config.json or the MCP settings.

Key features of Zammad MCP Server

Comprehensive API coverage for tickets, users, organizations, groups
Advanced access control with category‑ and tool‑level permissions
Supports API tokens, OAuth2, and basic authentication
Built with FastMCP, Pydantic, and modern Python practices
Smart caching for static data (groups, states, priorities)
Type-safe with full runtime validation and 90%+ test coverage

Use cases of Zammad MCP Server

Natural‑language ticket creation, search, and updates from an AI assistant
Automated customer communication drafting and escalation analysis
Admin operations like user management and organization maintenance
Real‑time health checks and server information retrieval
Secure, policy‑governed helpdesk access for external MCP clients

FAQ from Zammad MCP Server

What authentication methods does the Zammad MCP Server support?

It supports three methods: API token (recommended, via ZAMMAD_HTTP_TOKEN), OAuth2 token (ZAMMAD_OAUTH2_TOKEN), and username/password (ZAMMAD_USERNAME/ZAMMAD_PASSWORD).

How does access control work?

Access control is configured via environment variables: MCP_ALLOWED_CATEGORIES restricts which tool categories are available, MCP_DENIED_TOOLS blocks specific dangerous tools (e.g., delete_ticket), and MCP_ALLOWED_GROUPS limits operations to certain Zammad groups. Permission levels are DENIED, READ_ONLY, WRITE, or ADMIN.

What transports does the server support?

The server supports stdio transport (for local MCP clients like Claude Desktop) and SSE transport (for remote clients) using the --transport sse flag.

What dependencies are required to run the Zammad MCP Server?

Python 3.11 or newer, and the FastMCP library (2.0+). It is installed as a PyPI package and can be run directly with uvx without explicit installation.

How does this server differ from Zammad’s native AI features?

Zammad 7 includes built‑in AI summaries and writing assistance inside its UI. The Zammad MCP Server connects external MCP clients (Claude Desktop, Cursor, custom agents) to Zammad, enabling natural‑language interaction from outside the helpdesk. Both can coexist.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K