MCP Server for GLPI v3

A Model Context Protocol (MCP) server that exposes GLPI (IT Service Management) to AI assistants like Claude.

v3 is a foundations-and-coverage overhaul on top of v2. See CHANGELOG.md for the full list of changes; the rest of this README documents what's exposed today.

What's in v3

• Solid foundations: unified HTTP layer with auto re-authentication on 401, structured errors, retry on 5xx.
• Real search: multi-criteria with AND / OR / AND NOT / OR NOT, forcedisplay, pagination, fetch_all, dedicated count probe.
• Dynamic field mapping: /listSearchOptions/{itemtype} is cached so field_id ↔ name translations stay valid across GLPI versions.
• High-level reporting: glpi_search_tickets accepts friendly params, glpi_tickets_stats_by ventilates counts by status / category / technician / entity / month.
• Full ITIL coverage: timeline (followups + tasks + solutions + validations), validations request/approve, ticket linking, document attachment, satisfaction, overdue (SLA) tickets.
• Resolved foreign keys by default: detail views return users_id_tech: 42 and the resolved name, so the LLM doesn't have to guess.

Configuration

Env var	Required	Description
GLPI_URL	yes	Base URL of the GLPI instance
GLPI_APP_TOKEN	no	Application token (Setup → General → API)
GLPI_USER_TOKEN	no*	User API token
GLPI_USERNAME	no*	Login (when not using user token)
GLPI_PASSWORD	no*	Password (when not using user token)
GLPI_TIMEOUT_MS	no	HTTP request timeout in ms (default 15000)
GLPI_MAX_RETRIES	no	Max retries on 5xx / 429 / network errors (default 2)
GLPI_DEBUG	no	Set to any value to log HTTP retries/re-auth to stderr

* either GLPI_USER_TOKEN or GLPI_USERNAME+GLPI_PASSWORD is required.

Claude Desktop / Claude Code

{
  "mcpServers": {
    "glpi": {
      "command": "npx",
      "args": ["mcp-glpi"],
      "env": {
        "GLPI_URL": "https://glpi.example.com",
        "GLPI_APP_TOKEN": "...",
        "GLPI_USER_TOKEN": "..."
      }
    }
  }
}

Tool catalogue

Tickets — read

Tool	Description
glpi_list_tickets	List with start/limit/range/sort/order/status
glpi_get_ticket	Detail + status/urgency labels + counts of linked items
glpi_get_ticket_timeline	Followups + tasks + solutions + validations, chronological
glpi_search_tickets	High-level search (status, assigned, requester, dates, ...)
glpi_get_ticket_followups	Followups of a ticket
glpi_get_ticket_tasks	Tasks
glpi_get_ticket_solutions	Solutions
glpi_get_ticket_validations	Validations (approvals)
glpi_get_ticket_documents	Linked documents
glpi_get_ticket_satisfaction	Satisfaction survey result
glpi_list_overdue_tickets	Tickets whose SLA deadline has passed

Tickets — write

Tool	Description
glpi_create_ticket	Create a ticket
glpi_update_ticket	Update fields
glpi_delete_ticket	⚠️ Delete (force=true purges)
glpi_add_followup	Add a followup
glpi_add_task	Add a task with time tracking
glpi_add_solution	Add a solution
glpi_assign_ticket	Assign to user OR group
glpi_link_tickets	link / duplicate / parent
glpi_add_ticket_validation	Request a validation
glpi_set_validation_status	Approve (2) or refuse (3)
glpi_upload_document	Upload a local file as a Document; ticket_id attaches it in the same call
glpi_attach_document_to_ticket	Link an uploaded document to a ticket

Problems & Changes

Tool	Description
glpi_list_problems / glpi_get_problem / glpi_create_problem / glpi_update_problem	Problem management
glpi_list_changes / glpi_get_change / glpi_create_change / glpi_update_change	Change management

Assets

Tool family	Notes
Computer, Software, NetworkEquipment, Printer, Monitor, Phone	list_*, get_*, plus create/update/delete symmetry

Knowledge base, contracts, suppliers, locations, projects, documents

glpi_list_*, glpi_get_*, and glpi_create_* where the GLPI API allows it. glpi_search_knowbase performs a free-text search on the title (field id resolved dynamically — no longer hard-coded).

Users, groups, categories, entities

glpi_list_users filters active users via the search endpoint (not searchText); glpi_create_user/glpi_create_group/glpi_add_user_to_group cover provisioning.

Statistics

Tool	Description
glpi_get_ticket_stats	Counts by status (optional entity / date filters)
glpi_get_asset_stats	Total counts per asset type
glpi_tickets_stats_by	Ventilation by status / category / technician / entity / month, optional period

Generic / introspection

Tool	Description
glpi_search_v2	Multi-criteria search (criteria[], forcedisplay, fetch_all, ...)
glpi_count	Cheap totalcount probe with criteria
glpi_list_search_options	Catalogue of searchable fields for an itemtype
glpi_get_session_info	Active profile + available profiles + entities
glpi_search	Deprecated: single-criterion alias kept for backward compat

Resources

glpi://tickets/open, glpi://tickets/recent, glpi://problems/open, glpi://changes/pending, glpi://computers, glpi://groups, glpi://categories, glpi://stats/tickets, glpi://stats/assets.

Reference

Ticket status

ID	Label
1	New
2	Processing (assigned)
3	Processing (planned)
4	Pending
5	Solved
6	Closed

Validation status

ID	Label
1	Waiting
2	Granted
3	Refused

Urgency / impact / priority

ID	Label
1	Very low
2	Low
3	Medium
4	High
5	Very high

Change status

ID	Label
1	New
2	Evaluation
3	Approval
4	Accepted
5	Pending
6	Test
7	Qualification
8	Applied
9	Review
10	Closed
11	Refused
12	Canceled

Development

git clone https://github.com/GMS64260/mcp-glpi.git
cd mcp-glpi
npm install
npm run build
npm test          # node --test via tsx, mocked fetch

Run locally:

export GLPI_URL="https://glpi.example.com"
export GLPI_USER_TOKEN="..."
npm start

License

MIT

Links

• GLPI Project
• GLPI High-Level API
• Model Context Protocol
• NPM Package