LibreNMS MCP Server

by mhajderio.github.mhajder/librenms-mcpv1.11.3

MCP server for LibreNMS network monitoring - query devices, ports, alerts, and manage infrastructure

40Pythonstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install LibreNMS MCP server

claude mcp add librenms -e LIBRENMS_URL='<librenms-url>' -e LIBRENMS_TOKEN='<librenms-token>' -- uvx librenms-mcp

{
  "mcpServers": {
    "librenms": {
      "command": "uvx",
      "args": [
        "librenms-mcp"
      ],
      "env": {
        "LIBRENMS_URL": "<librenms-url>",
        "LIBRENMS_TOKEN": "<librenms-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "librenms": {
      "command": "uvx",
      "args": [
        "librenms-mcp"
      ],
      "env": {
        "LIBRENMS_URL": "<librenms-url>",
        "LIBRENMS_TOKEN": "<librenms-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "librenms": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "librenms-mcp"
      ],
      "env": {
        "LIBRENMS_URL": "<librenms-url>",
        "LIBRENMS_TOKEN": "<librenms-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "librenms": {
      "command": "uvx",
      "args": [
        "librenms-mcp"
      ],
      "env": {
        "LIBRENMS_URL": "<librenms-url>",
        "LIBRENMS_TOKEN": "<librenms-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
LIBRENMS_URL	yes	—	LibreNMS instance URL (e.g., https://librenms.example.com)
LIBRENMS_TOKEN	yes	yes	LibreNMS API token with appropriate permissions
LIBRENMS_VERIFY_SSL	—	—	Verify TLS certificates for LibreNMS requests (true/false)
LIBRENMS_TIMEOUT	—	—	HTTP timeout for LibreNMS API requests in seconds
READ_ONLY_MODE	—	—	Enable read-only mode to block write operations
DISABLED_TAGS	—	—	Comma-separated tool tags to disable (e.g., alerts,bills)
LOG_LEVEL	—	—	Logging level (DEBUG, INFO, WARNING, ERROR)
RATE_LIMIT_ENABLED	—	—	Enable per-client rate limiting (true/false)
RATE_LIMIT_MAX_REQUESTS	—	—	Maximum requests allowed per rate-limit window
RATE_LIMIT_WINDOW_MINUTES	—	—	Rate-limit window duration in minutes
TOOL_SEARCH_ENABLED	—	—	Enable FastMCP tool search transform
TOOL_SEARCH_STRATEGY	—	—	Tool search strategy: 'bm25' (natural language) or 'regex' (pattern match)
TOOL_SEARCH_MAX_RESULTS	—	—	Maximum number of tools returned by search_tools
SENTRY_DSN	—	yes	Sentry DSN for optional error tracking
SENTRY_TRACES_SAMPLE_RATE	—	—	Sentry traces sample rate (0.0-1.0)
SENTRY_SEND_DEFAULT_PII	—	—	Allow Sentry to include default PII in events (true/false)
SENTRY_ENVIRONMENT	—	—	Sentry environment name (e.g., production)
SENTRY_RELEASE	—	—	Sentry release identifier
SENTRY_PROFILE_SESSION_SAMPLE_RATE	—	—	Sentry profile session sample rate (0.0-1.0)
SENTRY_PROFILE_LIFECYCLE	—	—	Sentry profiling lifecycle mode
SENTRY_ENABLE_LOGS	—	—	Enable Sentry log capture integration (true/false)
MCP_HTTP_PORT	—	—	Port for HTTP server (default: 8000)
MCP_HTTP_BEARER_TOKEN	—	yes	Optional bearer token for HTTP transport authentication
MCP_TRANSPORT	—	—	MCP transport type (http for HTTP, stdio for stdio)

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-07 · 2d ago · GitHub · v1.11.3
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 2d ago · official registry · v1.11.3

FAQ

›How do I install the LibreNMS MCP server in Claude Code?

Run: claude mcp add librenms -e LIBRENMS_URL='<librenms-url>' -e LIBRENMS_TOKEN='<librenms-token>' -- uvx librenms-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does LibreNMS require an API key?

Yes. It expects LIBRENMS_URL, LIBRENMS_TOKEN, SENTRY_DSN, MCP_HTTP_BEARER_TOKEN, of which 3 are secrets.

›Can I use LibreNMS as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is LibreNMS in the official MCP registry?

Yes, as io.github.mhajder/librenms-mcp.