Zammad MCP Server
Connect Claude, Cursor, or any MCP client to your Zammad helpdesk with a production-ready Model Context Protocol server.
Zammad MCP Server
The Zammad MCP Server is a free, open-source Model Context Protocol (MCP) bridge between AI assistants and your Zammad instance. It exposes tickets, users, organizations, and groups as typed MCP tools so agents can search, summarize, and update helpdesk data through natural language — with granular access control and safe defaults.
- License: MIT
- Package:
zammad-mcp-serveron PyPI - Source: github.com/Softoft-Orga/zammad-mcp-server
Who is this for?
| Role | Typical use |
|---|---|
| Zammad administrators | Pilot AI on tickets without building a custom API integration |
| Support leads | Faster ticket lookup, summaries, and draft replies via Claude or Cursor |
| AI / automation engineers | Standard MCP tooling instead of one-off REST scripts |
| Consultants | Repeatable Zammad + MCP setup for client environments |
How this fits the Zammad + AI landscape
flowchart LR
subgraph native [Zammad 7 native AI]
Z7[Summaries and writing assistant inside Zammad UI]
end
subgraph mcp [Zammad MCP Server]
MCP[Claude Desktop Cursor custom agents]
end
subgraph otai [Open Ticket AI Runtime]
RT[Custom trained models on-prem routing]
end
Zammad[(Zammad REST API)]
Z7 --> Zammad
MCP --> Zammad
RT --> Zammad
- Zammad 7 native AI — built-in summaries, writing assistant, and AI agents inside the Zammad UI.
- Zammad MCP Server (this project) — connects external MCP clients (Claude Desktop, Cursor, your own agents) to Zammad.
- Open Ticket AI Runtime — on-prem inference with custom-trained classification models via the OTAI Zammad connector plugin (see Zammad + OTAI integration).
All three can coexist. MCP is the fastest path to “talk to my helpdesk from Claude.”
Key features
- 30+ MCP tools for tickets, articles, users, organizations, and groups
- Access control via environment variables (category allow/deny, tool deny-list, group scope)
- Multiple auth modes — API token (recommended), OAuth2, basic auth
- Install options —
pip,uvx, Docker, SSE transport for remote clients - Built-in prompts — ticket summary, customer communication, escalation analysis
- Resource URIs —
zammad://ticket/{id},zammad://user/{id},zammad://states
Documentation map
| Page | What you will learn |
|---|---|
| Quick Start | Install and run health_check in minutes |
| Claude & Cursor Setup | MCP client configuration |
| Configuration | Environment variables and access policies |
| Tools Reference | All MCP tools by category |
| Security | Tokens, least privilege, production checklist |
| Deployment | Docker, SSE, and production notes |
Learn more
Next steps
- Follow the Quick Start guide.
- Harden access with Security before production use.
- Need custom models trained on your queues? Explore Open Ticket AI for Zammad.
