{"_id":"@davycaetano/mcp-glpi","_rev":"2-97799441a8a39780bf6dbc8b20849f0c","name":"@davycaetano/mcp-glpi","dist-tags":{"latest":"2.1.1"},"versions":{"2.1.0":{"name":"@davycaetano/mcp-glpi","version":"2.1.0","keywords":["mcp","model-context-protocol","glpi","itsm","itil","helpdesk","service-desk","tickets","incidents","problems","changes","assets","inventory","cmdb","knowledge-base","contracts","projects","claude","anthropic","ai","llm","automation"],"author":{"name":"GMS64260"},"license":"MIT","_id":"@davycaetano/mcp-glpi@2.1.0","maintainers":[{"name":"davycaetano","email":"davycaetano18@gmail.com"}],"homepage":"https://github.com/DavyCaetano/mcp-glpi#readme","bugs":{"url":"https://github.com/DavyCaetano/mcp-glpi/issues"},"bin":{"mcp-glpi":"dist/index.js"},"dist":{"shasum":"325d25e0c9356bca9fbe0a4666e58a8e2fac4ff0","tarball":"https://registry.npmjs.org/@davycaetano/mcp-glpi/-/mcp-glpi-2.1.0.tgz","fileCount":11,"integrity":"sha512-qvjupxL63J8bLVyrQYN1IGjUpc9FQuh7XaG7e8ni4emFtZmx54SpyzwzF+84twGdclX39Ue1CoNYap1VDho/4Q==","signatures":[{"sig":"MEUCICcAppbrrRCxsxGu7+R4CTJh8Ur++rpxVCcXkuQlEtLVAiEA9PzaWVsm26ijEW3X70jvBiOv+gFtBKeNwYmS8PZ8F9s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":314471},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"ce3986f0e184bcc9c12c70c8ee8dba314308ce3d","scripts":{"dev":"ts-node src/index.ts","lint":"eslint src/**/*.ts","test":"jest","build":"tsc","start":"node dist/index.js","watch":"tsc --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"davycaetano","email":"davycaetano18@gmail.com"},"repository":{"url":"git+https://github.com/DavyCaetano/mcp-glpi.git","type":"git"},"_npmVersion":"11.8.0","description":"Full-featured MCP Server for GLPI - Complete IT Service Management integration with Claude (Tickets, Problems, Changes, Assets, Knowledge Base, Contracts, Projects)","directories":{},"_nodeVersion":"24.13.1","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-glpi_2.1.0_1776906781484_0.10492478007385753","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@davycaetano/mcp-glpi","version":"2.1.1","description":"Full-featured MCP Server for GLPI - Complete IT Service Management integration with Claude (Tickets, Problems, Changes, Assets, Knowledge Base, Contracts, Projects)","main":"dist/index.js","types":"dist/index.d.ts","bin":{"mcp-glpi":"dist/index.js"},"scripts":{"build":"tsc","watch":"tsc --watch","start":"node dist/index.js","dev":"ts-node src/index.ts","prepublishOnly":"npm run build","lint":"eslint src/**/*.ts","test":"jest"},"keywords":["mcp","model-context-protocol","glpi","itsm","itil","helpdesk","service-desk","tickets","incidents","problems","changes","assets","inventory","cmdb","knowledge-base","contracts","projects","claude","anthropic","ai","llm","automation"],"author":{"name":"GMS64260"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/DavyCaetano/mcp-glpi.git"},"bugs":{"url":"https://github.com/DavyCaetano/mcp-glpi/issues"},"homepage":"https://github.com/DavyCaetano/mcp-glpi#readme","engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.0"},"gitHead":"72bf15994e639c803e52fe57471f0b56d707c4b2","_id":"@davycaetano/mcp-glpi@2.1.1","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-oqva5nOJoloKNwNYhQlvLe0eQEUVaObEyL3/vUQQHE9TtDcnQZxkpFqLI/M+NkmqTiQUrDW3t4POVYBOdn+o/w==","shasum":"b58fdffda2c1a4358a58bacdb415b811194dd202","tarball":"https://registry.npmjs.org/@davycaetano/mcp-glpi/-/mcp-glpi-2.1.1.tgz","fileCount":11,"unpackedSize":318442,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCQ0Q+7jadtlzJIAO4fSzTyTn2jM3oav6hbuZgaWCdyZQIhAJ80MI6UVjmelBcQHBfQlARCwGVvVRseh6fhbdxBGu6z"}]},"_npmUser":{"name":"davycaetano","email":"davycaetano18@gmail.com"},"directories":{},"maintainers":[{"name":"davycaetano","email":"davycaetano18@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-glpi_2.1.1_1776908305233_0.6499958023715917"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-23T01:13:01.368Z","modified":"2026-04-23T01:38:25.542Z","2.1.0":"2026-04-23T01:13:01.633Z","2.1.1":"2026-04-23T01:38:25.438Z"},"bugs":{"url":"https://github.com/DavyCaetano/mcp-glpi/issues"},"author":{"name":"GMS64260"},"license":"MIT","homepage":"https://github.com/DavyCaetano/mcp-glpi#readme","keywords":["mcp","model-context-protocol","glpi","itsm","itil","helpdesk","service-desk","tickets","incidents","problems","changes","assets","inventory","cmdb","knowledge-base","contracts","projects","claude","anthropic","ai","llm","automation"],"repository":{"type":"git","url":"git+https://github.com/DavyCaetano/mcp-glpi.git"},"description":"Full-featured MCP Server for GLPI - Complete IT Service Management integration with Claude (Tickets, Problems, Changes, Assets, Knowledge Base, Contracts, Projects)","maintainers":[{"name":"davycaetano","email":"davycaetano18@gmail.com"}],"readme":"# MCP Server for GLPI v2.0\r\n\r\nA comprehensive Model Context Protocol (MCP) server providing full integration with GLPI (Gestionnaire Libre de Parc Informatique) for AI assistants like Claude.\r\n\r\n## What's New in v2.0\r\n\r\n- **ITIL Support**: Full Problem and Change management\r\n- **Asset Management**: Computers, Software, Network Equipment, Printers, Monitors, Phones\r\n- **Knowledge Base**: Search and create KB articles\r\n- **Contract & Supplier Management**: Track contracts and vendors\r\n- **Project Management**: Create and track projects\r\n- **Statistics**: Ticket and asset dashboards\r\n- **60+ Tools**: Comprehensive GLPI coverage\r\n\r\n## Features\r\n\r\n### Ticket Management (ITIL Incidents/Requests)\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_tickets` | List tickets with filters |\r\n| `glpi_get_ticket` | Get ticket details with followups and tasks |\r\n| `glpi_create_ticket` | Create a new ticket |\r\n| `glpi_update_ticket` | Update ticket fields |\r\n| `glpi_delete_ticket` | Delete a ticket |\r\n| `glpi_add_followup` | Add a followup comment |\r\n| `glpi_add_task` | Add a task with time tracking |\r\n| `glpi_add_solution` | Add solution to close ticket |\r\n| `glpi_assign_ticket` | Assign ticket to user/group |\r\n| `glpi_get_ticket_tasks` | Get ticket tasks (paginated) |\r\n| `glpi_get_ticket_followups` | Get ticket followups (paginated) |\r\n| `glpi_get_ticket_interactions` | Get followups/tasks/solutions/approvals (single or batch) |\r\n\r\n### Problem Management (ITIL)\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_problems` | List problems |\r\n| `glpi_get_problem` | Get problem details |\r\n| `glpi_create_problem` | Create a new problem |\r\n| `glpi_update_problem` | Update a problem |\r\n| `glpi_add_problem_followup` | Add followup to a problem |\r\n| `glpi_get_problem_followups` | Get problem followups (paginated) |\r\n| `glpi_add_problem_task` | Add task to a problem |\r\n| `glpi_get_problem_tasks` | Get problem tasks (paginated) |\r\n| `glpi_get_problem_interactions` | Get followups/tasks/solutions/approvals (single or batch) |\r\n\r\n### Change Management (ITIL)\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_changes` | List changes |\r\n| `glpi_get_change` | Get change details |\r\n| `glpi_create_change` | Create a new change |\r\n| `glpi_update_change` | Update a change |\r\n| `glpi_add_change_followup` | Add followup to a change |\r\n| `glpi_get_change_followups` | Get change followups (paginated) |\r\n| `glpi_add_change_task` | Add task to a change |\r\n| `glpi_get_change_tasks` | Get change tasks (paginated) |\r\n| `glpi_get_change_interactions` | Get followups/tasks/solutions/approvals (single or batch) |\r\n\r\n### Plugin Tags\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_plugin_tags` | List tags registered in plugin Tags |\r\n| `glpi_search_plugin_tag_items` | Search items linked to a tag (by `tag_id` or `tag_name`) |\r\n\r\n### Asset Management\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_computers` | List computers/workstations |\r\n| `glpi_get_computer` | Get computer with software/connections |\r\n| `glpi_create_computer` | Add computer to inventory |\r\n| `glpi_update_computer` | Update computer |\r\n| `glpi_delete_computer` | Remove computer |\r\n| `glpi_list_softwares` | List software |\r\n| `glpi_get_software` | Get software details |\r\n| `glpi_create_software` | Add software |\r\n| `glpi_list_network_equipments` | List switches/routers |\r\n| `glpi_get_network_equipment` | Get network device |\r\n| `glpi_list_printers` | List printers |\r\n| `glpi_get_printer` | Get printer details |\r\n| `glpi_list_monitors` | List monitors |\r\n| `glpi_get_monitor` | Get monitor details |\r\n| `glpi_list_phones` | List phones |\r\n| `glpi_get_phone` | Get phone details |\r\n\r\n### Knowledge Base\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_knowbase` | List KB articles |\r\n| `glpi_get_knowbase_item` | Get article content |\r\n| `glpi_search_knowbase` | Search knowledge base |\r\n| `glpi_create_knowbase_item` | Create new article |\r\n\r\n### Contract & Supplier Management\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_contracts` | List contracts |\r\n| `glpi_get_contract` | Get contract details |\r\n| `glpi_create_contract` | Create contract |\r\n| `glpi_list_suppliers` | List suppliers |\r\n| `glpi_get_supplier` | Get supplier details |\r\n| `glpi_create_supplier` | Create supplier |\r\n\r\n### Project Management\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_projects` | List projects |\r\n| `glpi_get_project` | Get project details |\r\n| `glpi_create_project` | Create project |\r\n| `glpi_update_project` | Update project progress |\r\n\r\n### User & Group Management\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_users` | List users |\r\n| `glpi_get_user` | Get user details |\r\n| `glpi_search_user` | Search user by name |\r\n| `glpi_create_user` | Create new user |\r\n| `glpi_list_groups` | List groups |\r\n| `glpi_get_group` | Get group details |\r\n| `glpi_create_group` | Create group |\r\n| `glpi_add_user_to_group` | Add user to group |\r\n\r\n### Other Tools\r\n| Tool | Description |\r\n|------|-------------|\r\n| `glpi_list_categories` | List ticket categories |\r\n| `glpi_list_locations` | List locations |\r\n| `glpi_get_location` | Get location details |\r\n| `glpi_create_location` | Create location |\r\n| `glpi_list_entities` | List entities |\r\n| `glpi_get_entity` | Get entity details |\r\n| `glpi_list_documents` | List documents |\r\n| `glpi_get_document` | Get document details |\r\n| `glpi_get_ticket_stats` | Ticket statistics |\r\n| `glpi_get_asset_stats` | Asset inventory stats |\r\n| `glpi_get_session_info` | Current session info |\r\n| `glpi_search` | Advanced multi-criteria search |\r\n\r\n### Pagination\r\n- Tools with `limit`/`offset` support enforce `limit` between `1` and `100`.\r\n- Default pagination is `limit=50` and `offset=0`.\r\n- Batch interaction tools accept `id` or `ids` (up to 100 IDs per request).\r\n\r\n### Resources (Quick Access)\r\n| Resource URI | Description |\r\n|--------------|-------------|\r\n| `glpi://tickets/open` | All open tickets |\r\n| `glpi://tickets/recent` | Recent tickets |\r\n| `glpi://problems/open` | Open problems |\r\n| `glpi://changes/pending` | Pending changes |\r\n| `glpi://computers` | All computers |\r\n| `glpi://groups` | All groups |\r\n| `glpi://categories` | Ticket categories |\r\n| `glpi://stats/tickets` | Ticket statistics |\r\n| `glpi://stats/assets` | Asset statistics |\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install -g mcp-glpi\r\n```\r\n\r\nOr use directly with npx:\r\n\r\n```bash\r\nnpx mcp-glpi\r\n```\r\n\r\n## Configuration\r\n\r\n### Environment Variables\r\n\r\n| Variable | Required | Description |\r\n|----------|----------|-------------|\r\n| `GLPI_URL` | Yes | Base URL of your GLPI instance |\r\n| `GLPI_APP_TOKEN` | No | Application token from GLPI API settings |\r\n| `GLPI_USER_TOKEN` | No* | User API token |\r\n| `GLPI_USERNAME` | No* | Username for basic auth |\r\n| `GLPI_PASSWORD` | No* | Password for basic auth |\r\n\r\n*Either `GLPI_USER_TOKEN` or `GLPI_USERNAME`/`GLPI_PASSWORD` is required.\r\n\r\n### GLPI API Setup\r\n\r\n1. Go to **Setup > General > API** in GLPI\r\n2. Enable the REST API\r\n3. Create an API client and note the App Token\r\n4. For user authentication, either:\r\n   - Use a User Token (found in user preferences under \"Remote access keys\")\r\n   - Or use username/password authentication\r\n\r\n### Claude Desktop Configuration\r\n\r\nAdd to your Claude Desktop configuration file:\r\n\r\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\r\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"glpi\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"mcp-glpi\"],\r\n      \"env\": {\r\n        \"GLPI_URL\": \"https://your-glpi-instance.com\",\r\n        \"GLPI_APP_TOKEN\": \"your-app-token\",\r\n        \"GLPI_USER_TOKEN\": \"your-user-token\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Usage Examples\r\n\r\nOnce configured, you can ask Claude to:\r\n\r\n### Ticket Management\r\n- \"List all open tickets in GLPI\"\r\n- \"Show me ticket #123 with all its tasks\"\r\n- \"Create a new incident for a printer issue\"\r\n- \"Add a solution to ticket #456\"\r\n- \"Assign ticket #789 to the support team\"\r\n\r\n### Problem & Change Management\r\n- \"List all open problems\"\r\n- \"Create a change request for the server upgrade\"\r\n- \"Show me pending changes for approval\"\r\n- \"Add a followup to problem #123\"\r\n- \"List tasks from change #456 with limit 100 and offset 0\"\r\n- \"Get all interactions for tickets 10, 20 and 30\"\r\n\r\n### Plugin Tags\r\n- \"List all registered tags from plugin tags\"\r\n- \"Find items linked to tag 'VPN' in plugin tags\"\r\n- \"Search only Ticket links for tag #12 in plugin tags\"\r\n\r\n### Asset Management\r\n- \"List all computers in the inventory\"\r\n- \"Show me computer PC-001 with its installed software\"\r\n- \"Add a new workstation to the inventory\"\r\n- \"List all network equipment\"\r\n\r\n### Knowledge Base\r\n- \"Search the knowledge base for VPN setup\"\r\n- \"Create a KB article about password reset\"\r\n- \"List FAQ articles\"\r\n\r\n### Reports & Statistics\r\n- \"Show me ticket statistics\"\r\n- \"Give me an asset inventory summary\"\r\n- \"How many tickets are pending?\"\r\n\r\n## Status References\r\n\r\n### Ticket Status\r\n| ID | Label |\r\n|----|-------|\r\n| 1 | New |\r\n| 2 | Processing (assigned) |\r\n| 3 | Processing (planned) |\r\n| 4 | Pending |\r\n| 5 | Solved |\r\n| 6 | Closed |\r\n\r\n### Problem Status\r\n| ID | Label |\r\n|----|-------|\r\n| 1 | New |\r\n| 2 | Accepted |\r\n| 3 | Planned |\r\n| 4 | Pending |\r\n| 5 | Solved |\r\n| 6 | Closed |\r\n\r\n### Change Status\r\n| ID | Label |\r\n|----|-------|\r\n| 1 | New |\r\n| 2 | Evaluation |\r\n| 3 | Approval |\r\n| 4 | Accepted |\r\n| 5 | Pending |\r\n| 6 | Test |\r\n| 7 | Qualification |\r\n| 8 | Applied |\r\n| 9 | Review |\r\n| 10 | Closed |\r\n\r\n### Urgency/Priority\r\n| ID | Label |\r\n|----|-------|\r\n| 1 | Very low |\r\n| 2 | Low |\r\n| 3 | Medium |\r\n| 4 | High |\r\n| 5 | Very high |\r\n\r\n## Development\r\n\r\n### Building from source\r\n\r\n```bash\r\ngit clone https://github.com/GMS64260/mcp-glpi.git\r\ncd mcp-glpi\r\nnpm install\r\nnpm run build\r\n```\r\n\r\n### Running locally\r\n\r\n```bash\r\nexport GLPI_URL=\"https://your-glpi-instance.com\"\r\nexport GLPI_USER_TOKEN=\"your-token\"\r\nnpm start\r\n```\r\n\r\n## License\r\n\r\nMIT\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Please open an issue or submit a pull request.\r\n\r\n## Links\r\n\r\n- [GLPI Project](https://glpi-project.org/)\r\n- [GLPI API Documentation](https://glpi-user-documentation.readthedocs.io/)\r\n- [Model Context Protocol](https://modelcontextprotocol.io/)\r\n- [NPM Package](https://www.npmjs.com/package/mcp-glpi)\r\n","readmeFilename":"README.md"}