# GLPI

ITIL service desk and asset manager with a Builder-documented REST API over every item type.

GLPI is a GPL IT service management suite: tickets, incidents, problems, changes, assets, contracts, licenses, knowledge base, projects, and a plugin marketplace. Teclib ships GLPI Network Cloud as the hosted edition. The repo carries apirest.md, a REST API that exposes session, search, and CRUD over every GLPI item type, which is what the community MCP wrappers proxy.

Alternative to: ServiceNow, Jira Service Management

- Capabilities: adaptable, operable
- Vertical: support-bookkeeping
- Shape: business-app
- Form factor: web-app
- Execution model: deterministic
- Provenance: human-written (recorded, never ranked)
- Repo: https://github.com/glpi-project/glpi (GPL-3.0), 6300 stars, last commit 2026-09-02
- Last activity: 2026-09-02
- Page: apps/glpi-project--glpi.html
- JSON: apps/glpi-project--glpi.json

## Use it when

- we are an MSP or internal IT team and want tickets, assets, and contracts in one place that our agent can query and update through a stable API
- we need ITIL-style incident, problem, and change records rather than a chat-first support inbox

## Gotchas

- REST API is disabled by default and needs an app token plus IP allowlist under Setup > General > API
- IT-helpdesk flavour: customer-facing support (chat, social channels) is not native
- GPL-3.0 copyleft; PHP 8.2+ and MariaDB 10.6+ required
- Official REST API v1 is being superseded by a High-Level API in GLPI 11; endpoint paths may change

## Editions

- Free (self-hosted): Free, open source
  - source: https://github.com/glpi-project/glpi
  - binary: https://github.com/glpi-project/glpi/releases
  - container: https://github.com/glpi-project/glpi/blob/main/docker-compose.yaml
- GLPI Network Cloud: Free, closed source
  - hosted: https://www.glpi-network.cloud

## Adaptable: make it yours

Effort: config-only (2 things to edit)

Install writes config/config_db.php (database) and most behavior is set in the admin UI: entities, ticket templates, business rules, SLAs, notifications. Overrides for constants live in config/local_define.php per the install docs. An SMB edits config_db.php once, then adapts through the UI and marketplace plugins rather than code. The REST API needs an app token (Setup > General > API) and a user token per agent.

- Env vars: none
- Config files: config/config_db.php, config/local_define.php
- Prompt files: none
- Accounts you'll need: none for self-host; Teclib account for GLPI Network Cloud

## Operable: what an agent can drive

Operability: official. Interface: api at https://github.com/glpi-project/glpi/blob/main/apirest.md (published by the builder, local).
Recommended wrapper: https://github.com/svtica/glpi-mcp. If an MCP is wanted over the official REST API: pushed 2026-09-02 (recency first); Unlicense; 4 stars. Breadth of tools not verified. Runner-up: https://github.com/GMS64260/mcp-glpi (24 stars, MIT, pushed 2026-08-05).

### Reach (partial coverage)

- Create, read, update, and search tickets: reachable. apirest.md: Get an item, Get all items, Search items, Add item(s), Update item(s), Delete item(s) for any itemtype including Ticket
- Manage incidents, problems, and changes: reachable. same generic item endpoints; Problem and Change are itemtypes
- Track assets and configuration items: reachable. Computer, Printer, NetworkEquipment and other asset itemtypes through generic CRUD; Get sub items for components
- Attach and download documents: reachable. apirest.md special cases: Upload a document file, Download a document file
- Bulk actions on many items: reachable. apirest.md: Get available massive actions, Apply massive action
- Knowledge base and FAQ: reachable. KnowbaseItem is an itemtype under the generic endpoints
- Contracts, licenses, and financial fields: reachable. Contract, SoftwareLicense itemtypes through generic CRUD
- Run inventory from endpoints: not reachable. inventory is pushed by GLPI Agent installed on machines, not driven through the REST API
- Build dashboards and reports: not reachable. no dashboard endpoints in apirest.md headings
- Install plugins and configure entities: not reachable. marketplace and admin configuration are UI and CLI (bin/console), not REST

## Code stack

- Languages: PHP, JavaScript, Twig
- Frameworks: Symfony components, Vue
- Package manager: composer, npm
- Database: MariaDB, MySQL
- Hosting target: self-host (Apache/nginx/IIS), docker-compose.yaml in repo

## Evidence and confidence

- formFactor: README prerequisites: web server, PHP, MariaDB (confidence 0.95)
- executionModel: no model SDKs in the feature list or composer.json topics seen (confidence 0.85)
- operability: apirest.md in glpi-project/glpi: POST apirest.php/initSession with 'Authorization: Basic base64(login:password)' or 'Authorization: user_token <token>' (Remote access key in User Preferences) plus an App-Token header from Setup > General > API; returns a Session-Token header used on every other call. Documents session, search, generic CRUD per itemtype, massive actions, document upload/download. No dashboard headings. (confidence 0.95)
- effort: config/ directory in repo holds only .gitkeep; config_db.php is generated by the installer; local_define.php named in glpi-install docs (not fetched, confidence 0.6) (confidence 0.6)
- editions: README: distributed under GPL v3; glpi-network.cloud demo link in README (confidence 0.7)
- active: gh api: pushed 2026-09-02, 6300 stars
- reach:  (confidence 0.8)

## Open questions

- GLPI Network Cloud pricing
- Confirm config/local_define.php is still the documented override file in GLPI 11
- Tool breadth of svtica/glpi-mcp versus GMS64260/mcp-glpi; the recency rule picked the smaller one

## Sources

- https://github.com/glpi-project/glpi (sourcing:support-bookkeeping:curated)
- https://github.com/glpi-project/glpi/blob/main/apirest.md (sourcing:support-bookkeeping:curated)
- https://github.com/GMS64260/mcp-glpi (sourcing:support-bookkeeping:registries)
- https://github.com/svtica/glpi-mcp (sourcing:support-bookkeeping:registries)