Skip to main content
Glama
mcp-glpi-it4

mcp-glpi-it4

by chicoIA

mcp-glpi-it4

English · Português

tests License: MIT Python 3.12+

MCP Server for GLPI through the High-level API v2.3 (OAuth2). It exposes tickets, computer inventory, users and configuration parameters as tools for MCP clients such as Claude Desktop and Claude Code.

  • API: api.php/v2.3 · Auth: OAuth2 Password Grant

  • Stack: Python 3.12 · FastMCP · httpx (async)

  • Safety: dry_run by default, and every write is revertible

  • Transports: stdio (local) and streamable-http (shared container)

Works with any GLPI 11 instance that has the v2.3 API enabled — set GLPI_BASE_URL to yours.

Why a new server

The public MCP servers we evaluated (GMS64260/mcp-glpi, svtica/glpi-mcp) authenticate through the legacy API (Session-Token), which is incompatible with v2.3/OAuth2, and they do not cover configuration parameters or rollback.

Related MCP server: glpi-mcp

Quick start — Docker

cp .env.example .env          # set GLPI_BASE_URL + OAuth credentials
docker build -t mcp-glpi-it4 .

# A) stdio — the MCP client starts one container per session
docker run -i --rm --env-file .env -v glpi_audit:/data mcp-glpi-it4

# B) streamable-http — one long-running server on http://localhost:8000/mcp
docker compose up -d

Mount glpi_audit:/data: that volume holds the rollback log. Full guide, client configuration and security notes: docs/en/DOCKER.md.

Quick start — local install

pip install -e ".[dev]"   # or: uv sync
cp .env.example .env
mcp-glpi-it4              # stdio

Configuration

Variable

Required

Default

Description

GLPI_BASE_URL

yes

—

Base URL of your GLPI instance

GLPI_CLIENT_ID / GLPI_CLIENT_SECRET

yes

—

OAuth client (Setup > OAuth Clients)

GLPI_USERNAME / GLPI_PASSWORD

yes

—

Service account

GLPI_API_VERSION

—

v2.3

API version

GLPI_OAUTH_SCOPE

—

api

OAuth scope

GLPI_WRITE_MODE

—

dry_run

dry_run (simulates) | live (executes)

GLPI_AUDIT_DIR

—

~/.mcp-glpi-it4

Where the rollback/error logs are written (/data in Docker)

GLPI_TIMEOUT / GLPI_MAX_RETRIES

—

15 / 3

HTTP tuning

MCP_TRANSPORT

—

stdio

stdio | streamable-http | sse

FASTMCP_HOST / FASTMCP_PORT

—

0.0.0.0 / 8000

HTTP transports only (read by FastMCP)

Use with Claude Desktop

Without Docker — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "glpi-it4": {
      "command": "python",
      "args": ["-m", "mcp_glpi_it4.server"],
      "env": {
        "PYTHONPATH": "/path/to/mcp-glpi-it4/src",
        "GLPI_BASE_URL": "https://glpi.example.com",
        "GLPI_CLIENT_ID": "...", "GLPI_CLIENT_SECRET": "...",
        "GLPI_USERNAME": "...", "GLPI_PASSWORD": "...",
        "GLPI_WRITE_MODE": "dry_run"
      }
    }
  }
}

With Docker, see docs/en/DOCKER.md. Prompt examples: docs/en/USAGE.md.

Tools (29)

Tool names and arguments are in Portuguese and are kept stable — renaming them would break existing prompts. Prompt in whatever language you like; the model maps your wording to the tool.

Tickets: glpi_listar_chamados, glpi_consultar_chamado, glpi_criar_chamado, glpi_atualizar_chamado, glpi_adicionar_acompanhamento, glpi_adicionar_tarefa, glpi_adicionar_solucao, glpi_atribuir_chamado, glpi_excluir_chamado.

Inventory: glpi_listar_computadores, glpi_consultar_ativo, glpi_criar_computador, glpi_atualizar_computador, glpi_excluir_computador.

Users: glpi_listar_usuarios, glpi_consultar_usuario, glpi_listar_perfis, glpi_criar_usuario, glpi_excluir_usuario.

Configuration: glpi_listar_config, glpi_consultar_config, glpi_atualizar_config.

Support/Safety: glpi_listar_categorias, glpi_listar_entidades, glpi_listar_grupos, glpi_status_sessao, glpi_modo_escrita, glpi_reverter, glpi_listar_reversiveis.

Safety and rollback

  • dry_run (default): every write only returns the payload it would send; nothing changes.

  • live: performs the write; each operation is recorded in rollback_log.json with a snapshot of the previous state.

  • Revert: glpi_reverter (one operation by audit_id, or all pending ones). See docs/en/ROLLBACK.md.

Documentation

Translations are welcome: add docs/<lang-tag>/ and README.<lang-tag>.md, then link them from the language row at the top. See DEVELOPMENT.md.

Tests

pip install -e ".[dev]"
pytest -q

License

MIT — see LICENSE. Copyright (c) 2026 IT4Solução and contributors.

You may use, copy, modify, merge, publish, distribute, sublicense and sell copies of this software, including commercially, provided the copyright notice and the license text are kept in all copies. The software is provided "as is", without warranty of any kind.

GLPI itself is a separate project, licensed under the GPL, and is not distributed here.

Available Tools

24 tools
glpi_adicionar_acompanhamentoC

Adiciona um acompanhamento (follow-up) ao chamado.

Inputs: ticket_id (required), content (required), is_private.

glpi_adicionar_solucaoB

Registra a solução do chamado (pode encerrá-lo conforme a config do GLPI).

Inputs: ticket_id (required), content (required), solutiontypes_id.

glpi_adicionar_tarefaB

Adiciona uma tarefa ao chamado. actiontime em segundos; state: 1=A fazer,2=Feito.

Inputs: ticket_id (required), content (required), actiontime, state.

glpi_atribuir_chamadoC

Define um ator no chamado. role: requester | observer | assign.

Inputs: ticket_id (required), role, users_id, groups_id.

glpi_atualizar_chamadoA

Atualiza campos de um chamado. Guarda o estado anterior para reversão.

Inputs: id (required), name, content, status, +2 more.

glpi_atualizar_computadorB

Atualiza um computador. Guarda o estado anterior para reversão.

Inputs: id (required), name, serial, states_id, +1 more.

glpi_atualizar_configA

Altera um parâmetro de configuração (reversível). Exige GLPI_WRITE_MODE=live. Parâmetros sensíveis (URL base, senhas, chaves) são bloqueados.

Inputs: context (required), name (required), value (required).

glpi_consultar_ativoA

Detalha um computador. Se incluir_softwares, agrega os softwares instalados.

Inputs: id (required), incluir_softwares.

glpi_consultar_chamadoA

Detalha um chamado. Se incluir_timeline, agrega follow-ups, tarefas e solução.

Inputs: id (required), incluir_timeline.

glpi_consultar_configC

Lê um parâmetro específico (ex.: context='core', name='default_requesttypes_id').

Inputs: context (required), name (required).

glpi_criar_chamadoB

Abre um novo chamado. type: 1=Incidente, 2=Requisição. urgency: 1..5. Em modo dry_run, retorna o payload sem criar.

Inputs: name (required), content (required), type, urgency, +3 more.

glpi_criar_computadorC

Cadastra um computador no inventário. Em dry_run, retorna o payload sem criar.

Inputs: name (required), serial, entities_id, states_id, +2 more.

glpi_excluir_chamadoC

Move o chamado para a lixeira (soft-delete, reversível via glpi_reverter).

Inputs: id (required).

glpi_excluir_computadorA

Move o computador para a lixeira (soft-delete, reversível via glpi_reverter).

Inputs: id (required).

glpi_listar_categoriasC

Lista as categorias ITIL para classificar chamados.

Inputs: limite.

glpi_listar_chamadosB

Lista chamados do GLPI com filtros opcionais e paginação. status: 1=Novo,2=Atribuído,3=Planejado,4=Pendente,5=Solucionado,6=Fechado. tipo: 1=Incidente,2=Requisição. prioridade: 1..6.

Inputs: status, tipo, prioridade, tecnico_id, +2 more.

glpi_listar_computadoresC

Lista computadores do inventário. 'busca' aplica RSQL =like= sobre o nome.

Inputs: busca, entities_id, states_id, limite, +1 more.

glpi_listar_configA

Lista parâmetros de configuração. Sem 'context' lista todos os contextos; com 'context' (ex.: 'core') lista os parâmetros daquele contexto.

Inputs: context.

glpi_listar_entidadesC

Lista as entidades disponíveis no GLPI.

Inputs: limite.

glpi_listar_gruposC

Lista os grupos do GLPI (para atribuição de chamados).

Inputs: limite.

glpi_listar_reversiveisA

Lista as operações de escrita ainda reversíveis (pendentes de reversão).

Inputs: no named parameters.

glpi_modo_escritaA

Informa o modo de escrita atual: dry_run (simula) ou live (executa).

Inputs: no named parameters.

glpi_reverterA

Reverte uma operação de escrita (por audit_id) ou TODAS as pendentes, em ordem reversa. Sem argumento, reverte o lote pendente registrado.

Inputs: audit_id.

glpi_status_sessaoA

Valida credenciais/conectividade autenticando na API (OAuth2).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 24 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose, covering different entities (chamados, computadores, config) and actions (CRUD, list, assign, etc.). No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent 'glpi_verb_noun' pattern in snake_case, making it easy to predict tool names and understand their function.

    Tool Count4/5

    24 tools is on the higher side but appropriate for the GLPI IT management domain, covering multiple entity types and operations without being excessive.

    Completeness4/5

    The tool set covers CRUD and lifecycle operations for chamados and computadores, plus configuration management and reversible operations. Missing some asset types, but core workflows are well-covered.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to GLPI IT Service Management, enabling ticket management, asset search, and ITIL processes via natural language.
      9 npm
      3
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Enables AI assistants to manage GLPI inventory, tickets, and CIA security fields via its REST API.
      9
      23 npm
      1
      ISC
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to interact with a GLPI instance through its REST API, allowing natural-language consultation, creation, and updating of tickets, followups, tasks, solutions, knowledge base articles, suppliers, contacts, contracts, and statistics.
      52
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Connects AI assistants to GLPI through the Model Context Protocol, enabling management of tickets, ITIL objects, assets, projects, tasks, documents, sessions, entities and massive actions via the legacy REST API. It supports GLPI 10 and 11 with safe defaults such as read-only mode, disabled destructive operations and masked secrets.
      MIT