otrs-mcp-server

spoonbobo/otrs-mcp-server

3.3

If you are the rightful owner of otrs-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server for OTRS API integration, enabling AI assistants to manage OTRS functionalities through standardized interfaces.

The OTRS MCP Server is designed to integrate with the Open Ticket Request System (OTRS) API, providing a seamless interface for AI assistants to interact with OTRS functionalities. This server allows for the creation, management, and retrieval of tickets and configuration items within OTRS, leveraging the Model Context Protocol (MCP) to standardize these interactions. By utilizing this server, users can automate and streamline their ticket management processes, ensuring efficient handling of support requests and configuration management. The server supports Docker containerization, making it easy to deploy and manage, and includes SSL/TLS support for secure communications. Additionally, it offers configurable tools for AI assistants, enhancing their ability to interact with OTRS data and perform various operations.

Features

  • Create, read, update, and search tickets
  • Access ticket history and detailed information
  • Manage configuration items (CMDB)
  • Session management and authentication
  • Docker containerization support

Usages

docker with Claude Desktop

{
  "mcpServers": {
    "otrs": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OTRS_BASE_URL=https://your-otrs-server/otrs/nph-genericinterface.pl/Webservice/TestInterface",
        "-e",
        "OTRS_USERNAME=your-username",
        "-e",
        "OTRS_PASSWORD=your-password",
        "-e",
        "OTRS_VERIFY_SSL=false",
        "-e",
        "OTRS_DEFAULT_QUEUE=Raw",
        "-e",
        "OTRS_DEFAULT_STATE=new",
        "-e",
        "OTRS_DEFAULT_PRIORITY=3 normal",
        "ghcr.io/yourusername/otrs-mcp-server:latest"
      ]
    }
  }
}

uv with Claude Desktop

{
  "mcpServers": {
    "otrs": {
      "command": "uv",
      "args": [
        "--directory",
        "<full path to otrs-mcp-server directory>",
        "run",
        "src/otrs_mcp/main.py"
      ],
      "env": {
        "OTRS_BASE_URL": "https://your-otrs-server/otrs/nph-genericinterface.pl/Webservice/TestInterface",
        "OTRS_USERNAME": "your-username",
        "OTRS_PASSWORD": "your-password",
        "OTRS_VERIFY_SSL": "false"
      }
    }
  }
}

Tools

  1. create_ticket

    Create a new ticket in OTRS

  2. get_ticket

    Get detailed information about a specific ticket

  3. search_tickets

    Search for tickets based on various criteria

  4. update_ticket

    Update an existing ticket's properties

  5. get_ticket_history

    Get the complete history of a ticket