mcp-glpi-it4
This MCP server lets you read and manage GLPI IT support data through the v2.3 OAuth2 API, with dry-run safety and reversible writes.
Tickets: list, view timelines, create, update, add follow-ups/tasks/solutions, assign requesters/observers/assignees, and soft-delete tickets.
Inventory: list and inspect computers, optionally with installed software, and create/update/soft-delete computers.
Users: list/view users, list profiles, create users, and delete users.
Configuration: list/read GLPI configuration parameters and update them reversibly, with sensitive values blocked.
Reference data: list ITIL categories, entities, and groups for classification and assignment.
Safety/rollback: check OAuth session status, see current write mode (
dry_run/live), list revertible operations, and revert one or all pending writes by audit ID.Deployment: run via stdio for local MCP clients or streamable-http for shared/container use.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-glpi-it4 list my open tickets"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-glpi-it4
English · Português
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 GrantStack: Python 3.12 · FastMCP · httpx (async)
Safety:
dry_runby default, and every write is revertibleTransports:
stdio(local) andstreamable-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 -dMount 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 # stdioConfiguration
Variable | Required | Default | Description |
| yes | — | Base URL of your GLPI instance |
| yes | — | OAuth client ( |
| yes | — | Service account |
| — |
| API version |
| — |
| OAuth scope |
| — |
|
|
| — |
| Where the rollback/error logs are written ( |
| — |
| HTTP tuning |
| — |
|
|
| — |
| 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 inrollback_log.jsonwith a snapshot of the previous state.Revert:
glpi_reverter(one operation byaudit_id, or all pending ones). See docs/en/ROLLBACK.md.
Documentation
English | Português | |
Usage | ||
Docker | ||
Rollback | ||
Development |
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 -qLicense
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 toolsglpi_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
Scored across 24 tools
Each tool has a clearly distinct purpose, covering different entities (chamados, computadores, config) and actions (CRUD, list, assign, etc.). No overlap or ambiguity.
All tools follow a consistent 'glpi_verb_noun' pattern in snake_case, making it easy to predict tool names and understand their function.
24 tools is on the higher side but appropriate for the GLPI IT management domain, covering multiple entity types and operations without being excessive.
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
Related MCP Connectors
MCP server for GLPI: tickets, ITIL, assets, knowledge base. GLPI 10/11. Not affiliated with Teclib'.
Read tickets, devices, alerts and invoices; create tickets, add comments, log time in Gorelo.
Manage repositories, users, releases, and automate GitHub workflows
Read tickets, contacts, companies, agents and groups; create, update and reply to tickets.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to GLPI IT Service Management, enabling ticket management, asset search, and ITIL processes via natural language.9 npm3MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to manage GLPI inventory, tickets, and CIA security fields via its REST API.923 npm1ISC
- AlicenseBqualityCmaintenanceEnables 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-
- AlicenseNot gradedqualityBmaintenanceConnects 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