Zammad

v1.0.0Communicationstable

A Model Context Protocol (MCP) server for Zammad integration, enabling AI assistants to interact with tickets, users, and organizations.

api-integrationclaude-codecustomer-supporthelpdeskmcp
Share:
32
Stars
0
Downloads
0
Weekly
0/5

What is Zammad?

Zammad is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server for zammad integration, enabling ai assistants to interact with tickets, users, and organizations.

A Model Context Protocol (MCP) server for Zammad integration, enabling AI assistants to interact with tickets, users, and organizations.

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol (MCP) server for Zammad integration

Use Cases

Interact with support tickets, users, and organizations in Zammad helpdesk.
Manage customer support workflows through AI assistant conversations.
Access and update helpdesk data via Model Context Protocol integration.
basher83

Maintainer

LicenseAGPL-3.0
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx zammad-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Zammad

The Zammad MCP server bridges AI assistants with Zammad, the open-source helpdesk and ticketing system, allowing agents to search, create, update, and comment on tickets, look up users and organizations, and retrieve system metadata like groups, states, and priorities — all through natural language. It supports multiple authentication methods (API token, OAuth2, or basic auth) and can output results in markdown or JSON. Support teams and DevOps engineers use it to automate ticket triage, draft responses, and query helpdesk data without leaving their AI workflow.

Prerequisites

  • A running Zammad instance with API access enabled
  • A Zammad API token (generated in your Zammad profile under Token Access)
  • Python 3.10+ and uvx (part of the uv toolchain) for the recommended install method
  • Docker (optional, for the containerized install)
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Generate a Zammad API token

In your Zammad web interface, navigate to your profile, open 'Token Access', and create a new personal access token with the required permissions (ticket read/write, user read, etc.).

2

Install uvx if not already available

uvx is part of the uv Python package manager. Install uv to get uvx.

curl -LsSf https://astral.sh/uv/install.sh | sh
3

Test the server from the command line

Run the server directly with uvx to confirm connectivity before wiring it into your MCP client.

ZAMMAD_URL=https://your-instance.zammad.com/api/v1 \
ZAMMAD_HTTP_TOKEN=your-api-token \
uvx --from git+https://github.com/basher83/zammad-mcp.git mcp-zammad
4

Add the server to your MCP client configuration

Open your claude_desktop_config.json and add the Zammad server block with the required environment variables.

{
  "mcpServers": {
    "zammad": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/basher83/zammad-mcp.git", "mcp-zammad"],
      "env": {
        "ZAMMAD_URL": "https://your-instance.zammad.com/api/v1",
        "ZAMMAD_HTTP_TOKEN": "your-api-token"
      }
    }
  }
}
5

Restart your MCP client and verify the connection

Restart Claude Desktop (or your client) and ask it to list available Zammad tools or retrieve ticket statistics to confirm the server is reachable.

Zammad Examples

Client configuration

Claude Desktop configuration using uvx with API token authentication.

{
  "mcpServers": {
    "zammad": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/basher83/zammad-mcp.git", "mcp-zammad"],
      "env": {
        "ZAMMAD_URL": "https://your-instance.zammad.com/api/v1",
        "ZAMMAD_HTTP_TOKEN": "your-api-token",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Prompts to try

Example prompts once the Zammad server is connected.

- "Search for all open tickets assigned to the support team"
- "Show me ticket #4521 with its full conversation history"
- "Create a new ticket for customer John Doe about a login issue, priority high"
- "Add a comment to ticket #3890: 'Issue escalated to engineering team'"
- "List all ticket states available in our Zammad instance"
- "Give me a summary of escalated tickets from the last 7 days"

Troubleshooting Zammad

Authentication fails with 401 Unauthorized

Verify that ZAMMAD_HTTP_TOKEN is set to a valid token from your Zammad profile's Token Access section, and that the token has not been revoked. Ensure ZAMMAD_URL ends with /api/v1 and includes the correct hostname.

TLS certificate errors when connecting to a self-hosted Zammad instance

Set the ZAMMAD_INSECURE=true environment variable to disable TLS verification. Use this only in development or internal environments — never in production.

The server installs but no tools appear in the MCP client

Check that MCP_TRANSPORT is set to stdio (the default) and that your config file uses the exact command and args shown above. Run the uvx command manually in a terminal to see any startup errors.

Frequently Asked Questions about Zammad

What is Zammad?

Zammad is a Model Context Protocol (MCP) server that model context protocol (mcp) server for zammad integration, enabling ai assistants to interact with tickets, users, and organizations. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Zammad?

Follow the installation instructions on the Zammad GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Zammad?

Zammad works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Zammad free to use?

Yes, Zammad is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "zammad-mcp": { "command": "npx", "args": ["-y", "zammad-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Zammad?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides