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`).
Z
Zammad MCP Server
@Softoft-Orga
Basic information
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.
Zammad MCP Server 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"
}
}
}
}Zammad MCP Server tools
26Check 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
Frequently asked questions
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.
More Other MCP servers
N
Next Generation Movers: free moving quotes (remote MCP)
Next Generation MoversFree moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
Senso MCP for Joomla
sensomediaSenso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea
Hindsight
vectorize-ioHindsight: Agent Memory That Learns
50.4K
Glasswarp
GlasswarpSee and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
P
PickFu MCP
PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct
Comments