Skip to content
NetBox MCP Server

NetBox MCP Server

by NetBox Labs
Released
2 views
v1.2.1
Apache-2.0
Repository Docs
Cloud & Infrastructure

Summary

NetBox Labs' official read-only MCP server — query your network source of truth by object type and filter, and read the change audit trail from an agent.

Features

  • Query core NetBox objects by type with filters
  • Fetch a single object's full record by ID
  • Read the change audit trail with filtering
  • Auto-discovery of plugin object types
  • Read-only by default — no write surface to misuse
  • stdio and HTTP transports

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. Restart the agent — the "NetBox MCP Server" tools will be available.
{
  "mcpServers": {
    "netbox-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/netbox-mcp-server",
        "run",
        "netbox-mcp-server"
      ],
      "env": {
        "NETBOX_URL": "https://netbox.example.com/",
        "NETBOX_TOKEN": "<YOUR_READ_ONLY_API_TOKEN>"
      }
    }
  }
}

Description

NetBox is the network source of truth that most infrastructure teams end up building their automation around, and this official server from NetBox Labs makes it readable by an agent without giving it a way to break anything.

The tool surface is deliberately three tools wide. get_objects retrieves core NetBox objects by type with filters; get_object_by_id pulls the full record for one object; get_changelogs reads the audit trail of who changed what and when. That is enough to answer the questions people actually ask a source of truth — which devices sit in this rack, what is on this VLAN, which prefixes are free, when did this interface description change — while GraphQL, dynamic model discovery and write access stay explicitly out of scope. Plugin object types can be auto-discovered on top of the always-available core types.

The project states its own design goal as "easy to get started with, hard to misuse": read-only by default, no plugin surface, and Apache 2.0 licensed so that forking is a first-class path for anyone who needs more.

Run it over stdio or HTTP with NETBOX_URL and a read-only NETBOX_TOKEN. Note the v1.0.0 breaking change: the entry point is now netbox-mcp-server, not server.py.

Related MCP Servers

MCP: Vanta

by Vanta

New

Vanta's official remote MCP server — query controls, tests, vendors, vulnerabilities and policies across SOC 2 and ISO 27001, and remediate failing tests from your agent.

ProductivityCloud & Infrastructure
1 views
Browse all MCP servers →