NetBox MCP MCP Server

io.github.mhajder/netbox-mcp

Repository Registry

What is the NetBox MCP MCP server?

MCP server for NetBox DCIM/IPAM with read-only and dry-run modes

How to install NetBox MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

NETBOX_URL
required
NetBox base URL (e.g., https://netbox.example.com)
NETBOX_TOKEN
required
secret
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)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "netbox-mcp": {
      "command": "uvx",
      "args": [
        "netbox-mcp"
      ],
      "env": {
        "NETBOX_URL": "<YOUR_NETBOX_URL>",
        "NETBOX_TOKEN": "<YOUR_NETBOX_TOKEN>",
        "NETBOX_VERIFY_SSL": "<YOUR_NETBOX_VERIFY_SSL>",
        "NETBOX_TIMEOUT": "<YOUR_NETBOX_TIMEOUT>",
        "NETBOX_BRANCHING_ENABLED": "<YOUR_NETBOX_BRANCHING_ENABLED>",
        "NETBOX_BRANCH": "<YOUR_NETBOX_BRANCH>",
        "NETBOX_PLUGIN_DISCOVERY": "<YOUR_NETBOX_PLUGIN_DISCOVERY>",
        "READ_ONLY_MODE": "<YOUR_READ_ONLY_MODE>",
        "DRY_RUN_MODE": "<YOUR_DRY_RUN_MODE>",
        "DISABLED_TAGS": "<YOUR_DISABLED_TAGS>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "RESPONSE_MAX_SIZE": "<YOUR_RESPONSE_MAX_SIZE>",
        "RATE_LIMIT_ENABLED": "<YOUR_RATE_LIMIT_ENABLED>",
        "RATE_LIMIT_MAX_REQUESTS": "<YOUR_RATE_LIMIT_MAX_REQUESTS>",
        "RATE_LIMIT_WINDOW_MINUTES": "<YOUR_RATE_LIMIT_WINDOW_MINUTES>",
        "TOOL_SEARCH_ENABLED": "<YOUR_TOOL_SEARCH_ENABLED>",
        "TOOL_SEARCH_STRATEGY": "<YOUR_TOOL_SEARCH_STRATEGY>",
        "TOOL_SEARCH_MAX_RESULTS": "<YOUR_TOOL_SEARCH_MAX_RESULTS>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>"
      }
    }
  }
}