LibreNMS
MCP server for LibreNMS network monitoring - query devices, ports, alerts, and manage infrastructure
What is LibreNMS?
LibreNMS is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for librenms network monitoring - query devices, ports, alerts, and manage infrastructure
MCP server for LibreNMS network monitoring - query devices, ports, alerts, and manage infrastructure
This server falls under the Monitoring & Observability category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for LibreNMS network monitoring - query devices,
Use Cases
Maintainer
Works with
Installation
PIP
pip install librenms-mcpManual Installation
pip install librenms-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use LibreNMS
The LibreNMS MCP Server connects AI assistants directly to a LibreNMS network monitoring instance, exposing tools for querying device inventories, port statistics, alerts, ARP tables, BGP sessions, VLANs, syslog entries, and billing records through natural language. Network engineers and infrastructure teams use it to interrogate their monitoring data conversationally — asking Claude to summarize alert states, identify problematic ports, or pull device health metrics — without logging into the LibreNMS web interface or writing API calls manually.
Prerequisites
- A running LibreNMS instance accessible via HTTP/HTTPS
- A LibreNMS API token with appropriate read (and optionally write) permissions
- Python 3.10+ and uv or pip installed on the machine running the MCP server
- An MCP-compatible client such as Claude Desktop
Generate a LibreNMS API token
In LibreNMS, go to your user settings (top-right menu → API Tokens) and create a new token. Copy the token value — it will only be shown once. Ensure the token user has at least read access to devices.
Install the librenms-mcp package
Install via pip or run directly with uvx. The PyPI package name is librenms-mcp.
pip install librenms-mcp
# or run without installing:
uvx librenms-mcpConfigure environment variables
The server requires LIBRENMS_URL (the base URL of your instance) and LIBRENMS_TOKEN (your API token). Optional variables control read-only mode, rate limiting, and transport.
export LIBRENMS_URL="https://librenms.example.com"
export LIBRENMS_TOKEN="your_api_token_here"Add the server to your MCP client configuration
Open claude_desktop_config.json and add the LibreNMS server entry with the required environment variables.
{
"mcpServers": {
"librenms": {
"command": "uvx",
"args": ["librenms-mcp"],
"env": {
"LIBRENMS_URL": "https://librenms.example.com",
"LIBRENMS_TOKEN": "your_api_token_here",
"READ_ONLY_MODE": "true"
}
}
}
}Restart your MCP client and verify connectivity
Restart Claude Desktop. Ask Claude to list your network devices — it will call the devices_list tool and return your device inventory. If successful, all other tools are working.
LibreNMS Examples
Client configuration
Claude Desktop configuration using uvx with READ_ONLY_MODE enabled for safe production use.
{
"mcpServers": {
"librenms": {
"command": "uvx",
"args": ["librenms-mcp"],
"env": {
"LIBRENMS_URL": "https://librenms.example.com",
"LIBRENMS_TOKEN": "your_librenms_api_token",
"READ_ONLY_MODE": "true",
"RATE_LIMIT_ENABLED": "true"
}
}
}
}Prompts to try
Queries that use the device, port, alert, ARP, BGP, and syslog tools to interrogate LibreNMS data.
- "List all my monitored network devices and their current status"
- "Show me all active alerts and which devices they're affecting"
- "Find all ports with utilization over 80% in the last hour"
- "Search the ARP table for MAC address 00:1A:2B:3C:4D:5E"
- "List all BGP sessions and highlight any that are down"
- "Show syslog entries from router-core-01 from the last 30 minutes"Troubleshooting LibreNMS
Authentication error: 401 Unauthorized
Verify LIBRENMS_TOKEN is set correctly and the token belongs to an active LibreNMS user. In LibreNMS, go to Settings → API → API Tokens to confirm the token is valid and not expired. Also ensure LIBRENMS_URL does not have a trailing slash.
Connection refused or SSL certificate errors
If your LibreNMS instance uses a self-signed certificate, you may need to set CURL_CA_BUNDLE or configure SSL verification in the server. Confirm LIBRENMS_URL uses the correct protocol (http vs https) and that the instance is reachable from the machine running the MCP server.
Write operations (add device, acknowledge alert) fail in read-only mode
If READ_ONLY_MODE is set to 'true', all mutating operations are disabled by design. To enable write operations, remove READ_ONLY_MODE from the environment or set it to 'false', and ensure the API token user has write permissions in LibreNMS.
Frequently Asked Questions about LibreNMS
What is LibreNMS?
LibreNMS is a Model Context Protocol (MCP) server that mcp server for librenms network monitoring - query devices, ports, alerts, and manage infrastructure It connects AI assistants to external tools and data sources through a standardized interface.
How do I install LibreNMS?
Install via pip with: pip install librenms-mcp. Then configure your AI client to connect to this MCP server.
Which AI clients work with LibreNMS?
LibreNMS works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is LibreNMS free to use?
Yes, LibreNMS is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
LibreNMS Alternatives — Similar Monitoring & Observability Servers
Looking for alternatives to LibreNMS? Here are other popular monitoring & observability servers you can use with Claude, Cursor, and VS Code.
Netdata
★ 78.9kReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Kubeshark
★ 11.9keBPF-powered network observability for Kubernetes. Indexes L4/L7 traffic with full K8s context, decrypts TLS without keys. Queryable by AI agents via MCP and humans via dashboard.
Mission Control
★ 4.9kSelf-hosted AI agent orchestration platform: dispatch tasks, run multi-agent workflows, monitor spend, and govern operations from one mission control dashboard.
Grafana
★ 3.0kThis MCP server enables natural-language querying of Grafana logs by automatically detecting log sources and service labels. It provides read-only access to log data with intelligent caching for efficient repeat queries.
Sentrux
★ 2.4kReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.
OpenInference
★ 986OpenTelemetry Instrumentation for AI Observability
Browse More Monitoring & Observability MCP Servers
Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up LibreNMS in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use LibreNMS?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.