Zammad (Mojood Connect)

Zammad MCP server

Ask Claude about your support desk in plain words: what's open for a customer, what needs attention, what a ticket says. Assign tickets and add internal notes from the same chat, with a confirmation step before anything changes. There is no tool that writes to a customer.

Built by Mojood Connect as a working demo for Zammad. It runs against any Zammad through its REST API. This repository includes a local Zammad with SAMPLE data for the support desk of a made-up company, Harbor Trading, so you can try it without touching a real instance.

Tools

Tool	What it does	Changes anything?
find_tickets	Find tickets by words, or list them: state, priority, owner, customer, company, and whether each is waiting on us or on the customer	No
get_ticket	One ticket with every message in order, internal notes marked	No
customer_overview	A company or person: its people, open tickets and how many are closed; asks which when a name matches several	No
needs_attention	Tickets with no owner, tickets waiting on us (oldest first), overdue pending reminders, high priority	No
add_internal_note	An internal note on a ticket, never shown to the customer	Yes, after confirmation
update_ticket	Assign a ticket, or change its state or priority	Yes, after confirmation

How changes are made safe. A call to add_internal_note or update_ticket without a confirmation changes nothing: it returns a plain summary ("On #43002 ("Wrong size on 40 room safes, order HT-SO-5521"): assign it to Karim Nasser.") and a one-time code. The change happens only when the same request comes back with that code, within 10 minutes. A code works once, and only for the request it was issued for. The server's instructions tell the model to show the summary and wait for the user's yes. Notes carry "via Claude (Mojood Connect demo)" and every change shows in the ticket's history under the token's user.

The server acts as the user who owns the API token, with that user's Zammad permissions.

Try it locally

Needs Docker (with Compose), uv and Python 3.13. Zammad wants about 4 GB of memory.

scripts/reset.sh                         # local Zammad on http://localhost:8090, filled with the SAMPLE desk
uv run --env-file .env zammad-mcp        # MCP server on http://127.0.0.1:8003/mcp (Streamable HTTP)

docker/compose.yml is Zammad's own compose file (zammad-docker-compose v17.5.4) unchanged; docker/compose.override.yml keeps the port on 127.0.0.1, drops the backup container and Elasticsearch (Zammad then searches its own database). scripts/reset.sh generates every password and the API token itself and keeps them in the git-ignored files docker/.env and .env; nothing is printed. scripts/up.sh starts it again after a restart without touching the data.

Claude Desktop: add this to claude_desktop_config.json (Settings › Developer), with the path to this folder:

{
  "mcpServers": {
    "zammad": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/zammad-mcp", "--env-file", "/path/to/zammad-mcp/.env", "zammad-mcp", "--stdio"]
    }
  }
}

Then ask: "What's open for Al Noor Hotels?", "What needs attention on the desk?", "Give the room safes ticket to Karim, and note that the 20 litre safes ship Thursday."

Your own Zammad: set ZAMMAD_URL, ZAMMAD_TOKEN (a token from your profile's Token Access) and ZAMMAD_SAMPLE=0.

The SAMPLE desk

Harbor Trading's support desk: three groups (Orders, Deliveries, Billing), four agents, six customer companies, seven customer contacts and 15 tickets. Message times are set relative to the day it is seeded, so there are always tickets with no owner, customers waiting on us for hours, two overdue reminders and a few closed tickets. Everyone and everything in it is made up.

Tests

uv run --env-file .env pytest            # unit tests (a fake Zammad API), plus live tests when the local Zammad runs

What a production version adds

This demo signs in with one API token. A production server for Zammad customers would add sign-in with each agent's own Zammad account, so Claude sees exactly the groups they may see; hosting with an audit log of every tool call; and more of the API (tags, links, time accounting, knowledge base, reply drafts for an agent to send). That is what Mojood Connect builds.

License

Apache 2.0. Zammad is a trademark of Zammad GmbH; this project is not made or endorsed by Zammad GmbH.