GLPI MCP Server v2

🌐 English version · Português (Brasil)

MCP (Model Context Protocol) server in TypeScript/Node for GLPI integration. Uses the GLPI API v2.3 (via OAuth2) to provide ITIL coverage and built-in tools (tickets, problems, changes, knowledgebase, stats, assets, administration) directly to AI agents.

This project consolidates multiple tools, avoids repeated requests, and delivers data in formats optimized for LLM consumption.

🌟 Credits and Acknowledgments

This project reuses structure and tool coverage from:

• GMS64260/mcp-glpi (MIT)

• DevSkillsIT/Skills-MCP-GLPI (MIT)

Adapted for the new GLPI API v2.3 (OAuth2). Thanks to the original authors (GMS64260 and DevSkillsIT) for the architectural inspiration and ITIL mapping business logic.

Related MCP server: GLPI MCP

🚀 Features (Tools)

Tools focused on productivity are provided, including:

• Assistance: Creation, update, search (with RSQL filters), and full read (including timeline in 1 request) of Tickets, Problems, and Changes. Statistics and follow-up addition.

• Knowledgebase: Article search and read.

• Assets: Computer listing and read (with flag for detailed specs inclusion).

• Administration: User search, user context read, and group listing.

🛠 Installation

1. Clone the repository or download the files.

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

⚙️ Configuration (.env)

Create a .env file in the project root, based on the .env.example file:

GLPI_BASE_URL=http://localhost:8080
GLPI_CLIENT_ID=seu_client_id_oauth2
GLPI_CLIENT_SECRET=seu_client_secret_oauth2
GLPI_USERNAME=usuario_glpi
GLPI_PASSWORD=senha_glpi

How to create the OAuth2 API Client in GLPI

1. Access GLPI (version 11 / v2.3 enabled).

2. Go to Configuration → OAuth Clients (/front/oauthclient.php).

3. Add a new client.

4. Under Grants, add Password (password grant — recommended for scripts/agents).

5. Under Scopes, select at least api (and user if using user context tools).

6. Save and copy the Client ID (identifier) and Client Secret shown on the saved item.

🔌 Registration in MCP Client

The server runs via stdio (node dist/index.js + environment variables), so any compatible MCP client can register it. Below are examples per client.

Claude Desktop / Claude Code

File claude_desktop_config.json (Desktop) or .mcp.json (Claude Code, in the project root):

{
  "mcpServers": {
    "glpi-v2": {
      "command": "node",
      "args": [
        "caminho/absoluto/para/glpi-mcp-v2/dist/index.js"
      ],
      "env": {
        "GLPI_BASE_URL": "http://localhost:8080",
        "GLPI_CLIENT_ID": "seu_client_id_oauth2",
        "GLPI_CLIENT_SECRET": "seu_client_secret_oauth2",
        "GLPI_USERNAME": "usuario_glpi",
        "GLPI_PASSWORD": "senha_glpi"
      }
    }
  }
}

Antigravity (IDE and CLI)

File ~/.gemini/config/mcp_config.json (global) or .agents/mcp_config.json (per workspace):

{
  "mcpServers": {
    "glpi-v2": {
      "command": "node",
      "args": [
        "caminho/absoluto/para/glpi-mcp-v2/dist/index.js"
      ],
      "env": {
        "GLPI_BASE_URL": "http://localhost:8080",
        "GLPI_CLIENT_ID": "seu_client_id_oauth2",
        "GLPI_CLIENT_SECRET": "seu_client_secret_oauth2",
        "GLPI_USERNAME": "usuario_glpi",
        "GLPI_PASSWORD": "senha_glpi"
      }
    }
  }
}

Codex CLI (OpenAI)

File ~/.codex/config.toml (global) or .codex/config.toml (per project, in a trusted environment):

[mcp_servers.glpi-v2]
command = "node"
args = ["caminho/absoluto/para/glpi-mcp-v2/dist/index.js"]

[mcp_servers.glpi-v2.env]
GLPI_BASE_URL = "http://localhost:8080"
GLPI_CLIENT_ID = "seu_client_id_oauth2"
GLPI_CLIENT_SECRET = "seu_client_secret_oauth2"
GLPI_USERNAME = "usuario_glpi"
GLPI_PASSWORD = "senha_glpi"

Or via codex mcp add glpi-v2 --command node --args absolute/path/to/glpi-mcp-v2/dist/index.js (interactive, for the env vars).

Hermes Agent

hermes mcp add glpi-v2 --command "node caminho/absoluto/para/glpi-mcp-v2/dist/index.js"

The environment variables (GLPI_BASE_URL, GLPI_CLIENT_ID, etc.) must be available in the environment where Hermes runs, or configured via .env in the project directory (the server loads them via dotenv, if applicable — check src/config.ts).

OpenClaw

File ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "glpi-v2": {
        "command": "node",
        "args": [
          "caminho/absoluto/para/glpi-mcp-v2/dist/index.js"
        ],
        "transport": "stdio",
        "env": {
          "GLPI_BASE_URL": "http://localhost:8080",
          "GLPI_CLIENT_ID": "seu_client_id_oauth2",
          "GLPI_CLIENT_SECRET": "seu_client_secret_oauth2",
          "GLPI_USERNAME": "usuario_glpi",
          "GLPI_PASSWORD": "senha_glpi"
        }
      }
    }
  }
}

Note: the Hermes Agent and OpenClaw examples above follow each project's public documentation at the time of writing, but have not been tested directly against this server. Validate the connection locally (list the exposed tools) before relying on it in production.

Alternative: HTTP transport

If the client does not support stdio, the server also exposes StreamableHTTPServerTransport (see src/httpServer.ts). Set MCP_TRANSPORT=http and, optionally, MCP_HTTP_PORT (default 3000) in the process environment variables. The endpoint is at http://localhost:<port>/mcp (POST) — point the client to that URL instead of a local command.

📄 OpenAPI Spec (development reference)

The swagger-v2.3.json file (complete OpenAPI spec of the v2.3 API, dynamically generated by GLPI) is not versioned (git-ignored — 4.6MB, generated). To regenerate from a running GLPI instance:

curl -s "http://SEU_GLPI/api.php/doc.json" -o swagger-v2.3.json

🌐 HTTP Mode (Express)

The server optionally supports HTTP communication, using the recommended stateless endpoint (POST /mcp). To enable this mode, set the environment variables:

• MCP_TRANSPORT=http (default is stdio)

• MCP_HTTP_PORT=3000 (Optional, sets the Express server port)

Example request to list the tools using curl:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

License

MIT