Zammad Mcp Server
@Softoft-Orga
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.
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.
