zammad-mcp

MCP Server for Zammad — use your helpdesk tickets directly in Claude Code and VS Code.

Quick Install

npx zammad-mcp-setup

The wizard will ask for your Zammad URL, API token, and install the config automatically into Claude Code or VS Code.

Manual Install

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "zammad": {
      "command": "npx",
      "args": ["-y", "zammad-mcp"],
      "env": {
        "ZAMMAD_URL": "https://support.yourcompany.com",
        "ZAMMAD_TOKEN": "your-api-token-here"
      }
    }
  }
}

Or with username/password:

{
  "mcpServers": {
    "zammad": {
      "command": "npx",
      "args": ["-y", "zammad-mcp"],
      "env": {
        "ZAMMAD_URL": "https://support.yourcompany.com",
        "ZAMMAD_USER": "[email protected]",
        "ZAMMAD_PASSWORD": "your-password"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | list_tickets | List tickets (filter by state: open/closed/pending/all) | | get_ticket | Get full ticket details + all messages | | search_tickets | Search tickets by keyword | | get_ticket_articles | Get full conversation thread | | add_note_to_ticket | Add internal note to a ticket | | update_ticket_state | Close/reopen/set pending | | list_groups | List all groups/teams | | list_users | List agents/users |

Example Prompts

Show me all open tickets in Zammad
Search for tickets about "login error"
Get ticket #1234 and summarize the problem
Add a note to ticket #42 that the issue is being investigated
What are the most common error patterns in our open tickets?

Team Setup (Central Server)

For teams, run the MCP server centrally so everyone connects to one instance:

# On your server
ZAMMAD_URL=https://... ZAMMAD_TOKEN=... node dist/index.js --transport sse --port 3100

Team members add to their settings:

{
  "mcpServers": {
    "zammad": {
      "url": "http://your-server:3100/sse"
    }
  }
}

Create API Token in Zammad

1. Log in to Zammad
2. Click your avatar → Profile
3. Go to Token Access
4. Click Create
5. Copy the token

License

MIT