How do I install NetBox MCP Server?

Follow the setup instructions on the NetBox GitHub repository, then add the server configuration to your AI client.

What category is NetBox MCP Server?

NetBox is categorized under Databases. Browse more servers in these categories on MCPgee.

NetBox

Name: netbox-mcp
Author: gutierrezx7

v1.0.0•Databases•stable

This repository implements an MCP (Model Connector Plugin) server for NetBox with full CRUD capabilities, search, and changelog retrieval.

mcpmcp-servernetbox

174

Stars

Downloads

Weekly

0/5

View on GitHub

What is NetBox?

NetBox is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this repository implements an mcp (model connector plugin) server for netbox with full crud capabilities, search, and changelog retrieval.

This repository implements an MCP (Model Connector Plugin) server for NetBox with full CRUD capabilities, search, and changelog retrieval.

This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

This repository implements an MCP (Model Connector Plugin) s

Use Cases

Query and manage network infrastructure with CRUD operations.

Search NetBox for network device and inventory information.

Access network configuration history and changelog.

gutierrezx7

Maintainer

LicenseApache 2.0

Languagepython

Versionv1.0.0

UpdatedMay 18, 2026

Statushealthy

Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

View Source Browse All Servers

Installation

Manual Installation

npx netbox

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms

ThroughputMedium

Resource Usage

Memory UsageLow

CPU UsageLow

How to Set Up and Use NetBox

netbox-mcp is a Python MCP server that bridges AI assistants with NetBox, the open-source network infrastructure management platform. It provides full CRUD capabilities for NetBox objects (devices, IP addresses, prefixes, racks, sites, and more), plus search and changelog retrieval, so network engineers can query and update their source-of-truth inventory using natural language through Claude or any other MCP client.

Prerequisites

Python 3.10 or later and pip installed
A running NetBox instance (self-hosted or cloud) accessible over HTTP/HTTPS
A NetBox API token with appropriate read/write permissions
An MCP-compatible client such as Claude Desktop

Clone the repository

The server is installed from source. Clone the repository to your local machine.

git clone https://github.com/gutierrezx7/netbox-mcp.git
cd netbox-mcp

Install Python dependencies

Install the required packages listed in requirements.txt into your environment.

pip install -r requirements.txt

Configure environment variables

Copy the example environment file and fill in your NetBox URL and API token. Optionally set TIMEOUT (seconds) and RATE_LIMIT to control request pacing.

cp .env.example .env
# Edit .env and set:
# NETBOX_URL=https://netbox.example.com
# NETBOX_TOKEN=your_api_token_here
# TIMEOUT=30
# RATE_LIMIT=10

Run the MCP server

Start the server. It will read configuration from the .env file and begin listening for MCP connections.

python -m netbox_mcp_server

Register the server with Claude Desktop

Add the server entry to claude_desktop_config.json so Claude Desktop can launch and communicate with it.

NetBox Examples

Client configuration

{
  "mcpServers": {
    "netbox": {
      "command": "python",
      "args": ["-m", "netbox_mcp_server"],
      "env": {
        "NETBOX_URL": "https://netbox.example.com",
        "NETBOX_TOKEN": "your_api_token_here",
        "TIMEOUT": "30",
        "RATE_LIMIT": "10"
      }
    }
  }
}

Prompts to try

Ask Claude to query and manage your NetBox inventory using natural language.

- "List all active devices in the NYC datacenter site"
- "Show me all available IP prefixes in the 10.0.0.0/8 block"
- "What changes were made to the network inventory in the last 24 hours? Check the changelog"

Troubleshooting NetBox

Connection refused when starting the server

Verify that NETBOX_URL in .env is reachable from the machine running the MCP server. Try 'curl $NETBOX_URL/api/' to confirm the NetBox API responds. Check that HTTPS certificates are valid or set VERIFY_SSL=false for self-signed certs.

401 Unauthorized errors on NetBox API calls

Confirm that NETBOX_TOKEN is set correctly and that the token has not expired. In NetBox, navigate to Admin > API Tokens to verify the token status and permissions.

Rate limit errors when performing many queries

Lower the RATE_LIMIT value in your .env file to reduce the number of requests per second sent to NetBox, or increase the NetBox API rate limit in your NetBox server configuration.

Frequently Asked Questions about NetBox

What is NetBox?

NetBox is a Model Context Protocol (MCP) server that this repository implements an mcp (model connector plugin) server for netbox with full crud capabilities, search, and changelog retrieval. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install NetBox?

Follow the installation instructions on the NetBox GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with NetBox?

NetBox works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is NetBox free to use?

Yes, NetBox is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

NetBox Alternatives — Similar Databases Servers

Looking for alternatives to NetBox? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.

Excelize

★ 20.6k

Go language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets

MCP Toolbox for Databases

★ 15.3k

Open source MCP server specializing in easy, fast, and secure tools for Databases.

DBHub

★ 2.8k

A universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.

Tabularis

★ 2.1k

A lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.

Postgres AI Guide

★ 1.7k

MCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.

Anyquery

★ 1.7k

🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.

Browse More Databases MCP Servers

Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Databases Browse All Servers

Set Up NetBox in Your Editor

Choose your AI client for step-by-step setup instructions.

🖥️

Claude Desktop

macOS & Windows app

⌨️

Claude Code

CLI & terminal

📝

Cursor

AI-first code editor

💻

VS Code

GitHub Copilot MCP

🏄

Windsurf

Codeium AI editor

🔌

Cline

VS Code extension

Quick Config Preview

{
  "mcpServers": {
    "netbox": {
      "command": "npx",
      "args": ["-y", "netbox"]
    }
  }
}

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use NetBox?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides

Explore All Servers Read Our Guides