Model Context Protocol (MCP) server for read-only interaction with NetBox data in LLMs
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add netbox --env NETBOX_URL='<NETBOX_URL>' --env NETBOX_TOKEN='<NETBOX_TOKEN>' -- uv --directory /path/to/netbox-mcp-server run server.py~/.codex/config.toml
[mcp_servers.netbox]
command = "uv"
args = ["--directory", "/path/to/netbox-mcp-server", "run", "server.py"]
env = { NETBOX_URL = "<NETBOX_URL>", NETBOX_TOKEN = "<NETBOX_TOKEN>" }
# codex mcp add netbox --env NETBOX_URL='<NETBOX_URL>' --env NETBOX_TOKEN='<NETBOX_TOKEN>' -- uv --directory /path/to/netbox-mcp-server run server.py~/.cursor/mcp.json
{
"mcpServers": {
"netbox": {
"command": "uv",
"args": [
"--directory",
"/path/to/netbox-mcp-server",
"run",
"server.py"
],
"env": {
"NETBOX_URL": "<NETBOX_URL>",
"NETBOX_TOKEN": "<NETBOX_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"netbox": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"/path/to/netbox-mcp-server",
"run",
"server.py"
],
"env": {
"NETBOX_URL": "<NETBOX_URL>",
"NETBOX_TOKEN": "<NETBOX_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"netbox": {
"command": "uv",
"args": [
"--directory",
"/path/to/netbox-mcp-server",
"run",
"server.py"
],
"env": {
"NETBOX_URL": "<NETBOX_URL>",
"NETBOX_TOKEN": "<NETBOX_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"netbox": {
"command": "uv",
"args": [
"--directory",
"/path/to/netbox-mcp-server",
"run",
"server.py"
],
"env": {
"NETBOX_URL": "<NETBOX_URL>",
"NETBOX_TOKEN": "<NETBOX_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"netbox": {
"command": "uv",
"args": [
"--directory",
"/path/to/netbox-mcp-server",
"run",
"server.py"
],
"env": {
"NETBOX_URL": "<NETBOX_URL>",
"NETBOX_TOKEN": "<NETBOX_TOKEN>"
}
}
}
}Environment variables
NETBOX_URLNETBOX_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.