NetBox MCP Server
by mhajderio.github.mhajder/netbox-mcpv0.1.0
MCP server for NetBox DCIM/IPAM with read-only and dry-run modes
context tax
queued
security
queued
cold start
queued
freshness
Active13d ago
Install NetBox MCP server
Install in Claude Code
claude mcp add netbox -e NETBOX_URL='<netbox-url>' -e NETBOX_TOKEN='<netbox-token>' -- uvx netbox-mcpInstall in Cursor
{
"mcpServers": {
"netbox": {
"command": "uvx",
"args": [
"netbox-mcp"
],
"env": {
"NETBOX_URL": "<netbox-url>",
"NETBOX_TOKEN": "<netbox-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"netbox": {
"command": "uvx",
"args": [
"netbox-mcp"
],
"env": {
"NETBOX_URL": "<netbox-url>",
"NETBOX_TOKEN": "<netbox-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"netbox": {
"type": "stdio",
"command": "uvx",
"args": [
"netbox-mcp"
],
"env": {
"NETBOX_URL": "<netbox-url>",
"NETBOX_TOKEN": "<netbox-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"netbox": {
"command": "uvx",
"args": [
"netbox-mcp"
],
"env": {
"NETBOX_URL": "<netbox-url>",
"NETBOX_TOKEN": "<netbox-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| NETBOX_URL | yes | — | NetBox base URL (e.g., https://netbox.example.com) |
| NETBOX_TOKEN | yes | yes | NetBox API token: v2 (nbt_<key>.<token>, NetBox 4.5+) or legacy v1 |
| NETBOX_VERIFY_SSL | — | — | Verify SSL certificates (true/false) |
| NETBOX_TIMEOUT | — | — | Total time allowed for one NetBox request, retries included (seconds) |
| NETBOX_BRANCHING_ENABLED | — | — | Enable netbox-branching support: branch tools and the 'branch' argument (requires the netbox-branching plugin) (true/false) |
| NETBOX_BRANCH | — | — | Default netbox-branching branch (name or schema ID) for every call; requires NETBOX_BRANCHING_ENABLED=true |
| NETBOX_PLUGIN_DISCOVERY | — | — | Discover plugin object types from /api/core/object-types/ (true/false) |
| READ_ONLY_MODE | — | — | Hide all write tools (create, update, delete) (true/false) |
| DRY_RUN_MODE | — | — | Write tools only simulate changes and never modify NetBox (true/false) |
| DISABLED_TAGS | — | — | Comma-separated tool tags to disable (e.g. delete,graphql,branching) |
| LOG_LEVEL | — | — | Logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL) |
| RESPONSE_MAX_SIZE | — | — | Maximum tool response size in bytes (unset = unlimited) |
| RATE_LIMIT_ENABLED | — | — | Enable rate limiting |
| RATE_LIMIT_MAX_REQUESTS | — | — | Maximum requests per rate limit window |
| RATE_LIMIT_WINDOW_MINUTES | — | — | Rate limit window in minutes |
| TOOL_SEARCH_ENABLED | — | — | Enable FastMCP tool search transform |
| TOOL_SEARCH_STRATEGY | — | — | Tool search strategy (bm25 or regex) |
| TOOL_SEARCH_MAX_RESULTS | — | — | Maximum tool search results returned by search_tools |
| MCP_HTTP_PORT | — | — | Port for HTTP server (default: 8000) |
| MCP_TRANSPORT | — | — | MCP transport type (http for HTTP, stdio for stdio) |
Freshness
Active — last maintenance signal 13d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-26 · 13d ago · GitHub
Latest release
2026-09-26 · 13d ago · GitHub · v0.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-26 · 13d ago · official registry · v0.1.0
FAQ
›How do I install the NetBox MCP server in Claude Code?
Run: claude mcp add netbox -e NETBOX_URL='<netbox-url>' -e NETBOX_TOKEN='<netbox-token>' -- uvx netbox-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does NetBox require an API key?
Yes. It expects NETBOX_URL, NETBOX_TOKEN, of which 1 is a secret.
›Can I use NetBox as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is NetBox in the official MCP registry?
Yes, as io.github.mhajder/netbox-mcp.