S2 Netbox MCP Server
by j-maffio.github.J-MaFf/s2-netbox-mcpv0.3.0
MCP server for LenelS2 S2 NetBox access control via the NBAPI. Read-only by default.
context tax
queued
security
queued
cold start
queued
freshness
Active16d ago
Install S2 Netbox MCP server
Install in Claude Code
claude mcp add s2-netbox -e NETBOX_BASE_URL='<netbox-base-url>' -e NETBOX_USERNAME='<netbox-username>' -e NETBOX_PASSWORD='<netbox-password>' -- npx -y s2-netbox-mcpInstall in Cursor
{
"mcpServers": {
"s2-netbox": {
"command": "npx",
"args": [
"-y",
"s2-netbox-mcp"
],
"env": {
"NETBOX_BASE_URL": "<netbox-base-url>",
"NETBOX_USERNAME": "<netbox-username>",
"NETBOX_PASSWORD": "<netbox-password>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"s2-netbox": {
"command": "npx",
"args": [
"-y",
"s2-netbox-mcp"
],
"env": {
"NETBOX_BASE_URL": "<netbox-base-url>",
"NETBOX_USERNAME": "<netbox-username>",
"NETBOX_PASSWORD": "<netbox-password>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"s2-netbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"s2-netbox-mcp"
],
"env": {
"NETBOX_BASE_URL": "<netbox-base-url>",
"NETBOX_USERNAME": "<netbox-username>",
"NETBOX_PASSWORD": "<netbox-password>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"s2-netbox": {
"command": "npx",
"args": [
"-y",
"s2-netbox-mcp"
],
"env": {
"NETBOX_BASE_URL": "<netbox-base-url>",
"NETBOX_USERNAME": "<netbox-username>",
"NETBOX_PASSWORD": "<netbox-password>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| NETBOX_BASE_URL | yes | — | Base URL of the S2 NetBox controller's web interface, e.g. https://netbox.example.internal (no trailing slash or path) |
| NETBOX_USERNAME | yes | — | NBAPI session-login username |
| NETBOX_PASSWORD | yes | yes | NBAPI session-login password |
| NETBOX_ENABLE_WRITES | — | — | Set to true/1/yes to register the write tools (lock/unlock, add/modify/delete). Unset keeps the server strictly read-only. |
| NETBOX_ENABLE_DESTRUCTIVE | — | — | Set to true/1/yes together with NETBOX_ENABLE_WRITES to additionally register the 11 destructive (delete/remove) tools |
Freshness
Active — last maintenance signal 16d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-23 · 16d ago · GitHub
Latest release
2026-09-23 · 16d ago · GitHub · v0.5.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-16 · 23d ago · official registry · v0.3.0
FAQ
›How do I install the S2 Netbox MCP server in Claude Code?
Run: claude mcp add s2-netbox -e NETBOX_BASE_URL='<netbox-base-url>' -e NETBOX_USERNAME='<netbox-username>' -e NETBOX_PASSWORD='<netbox-password>' -- npx -y s2-netbox-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does S2 Netbox require an API key?
Yes. It expects NETBOX_BASE_URL, NETBOX_USERNAME, NETBOX_PASSWORD, of which 1 is a secret.
›Can I use S2 Netbox as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is S2 Netbox in the official MCP registry?
Yes, as io.github.J-MaFf/s2-netbox-mcp.