NetBox MCP Server

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

Local serverstdiostreamable-http

What is the NetBox MCP Server?

NetBox MCP is an MCP integration. MCP server for NetBox DCIM/IPAM with read-only and dry-run modes.

Packages and local setup

The published pypi package is netbox-mcp, version 0.1.0. Its declared MCP transport is stdio.

The package declares NETBOX_URL (required): NetBox base URL (e.g., https://netbox.example.com); NETBOX_TOKEN (required): NetBox API token: v2 (nbt_ . , 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.

The published pypi package is netbox-mcp, version 0.1.0. Its declared MCP transport is streamable-http.

The package declares NETBOX_URL (required): NetBox base URL (e.g., https://netbox.example.com); NETBOX_TOKEN (required): NetBox API token: v2 (nbt_ . , 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).

The published oci package is ghcr.io/mhajder/netbox-mcp:0.1.0. Its declared MCP transport is streamable-http.

The package declares NETBOX_URL (required): NetBox base URL (e.g., https://netbox.example.com); NETBOX_TOKEN (required): NetBox API token: v2 (nbt_ . , 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).

This package has launch arguments in its registry record. Use the maintainer’s configuration for those arguments rather than launching it with only the package name.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.1.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related other integrations MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
NETBOX_URLNetBox base URL (e.g., https://netbox.example.com)Yes
NETBOX_TOKENNetBox API token: v2 (nbt_ . , NetBox 4.5+) or legacy v1Yes
NETBOX_VERIFY_SSLVerify SSL certificates (true/false)Optional
NETBOX_TIMEOUTTotal time allowed for one NetBox request, retries included (seconds)Optional
NETBOX_BRANCHING_ENABLEDEnable netbox-branching support: branch tools and the 'branch' argument (requires the netbox-branching plugin) (true/false)Optional
NETBOX_BRANCHDefault netbox-branching branch (name or schema ID) for every call; requires NETBOX_BRANCHING_ENABLED=trueOptional
NETBOX_PLUGIN_DISCOVERYDiscover plugin object types from /api/core/object-types/ (true/false)Optional
READ_ONLY_MODEHide all write tools (create, update, delete) (true/false)Optional
DRY_RUN_MODEWrite tools only simulate changes and never modify NetBox (true/false)Optional
DISABLED_TAGSComma-separated tool tags to disable (e.g. delete,graphql,branching)Optional
LOG_LEVELLogging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)Optional
RESPONSE_MAX_SIZEMaximum tool response size in bytes (unset = unlimited)Optional
RATE_LIMIT_ENABLEDEnable rate limitingOptional
RATE_LIMIT_MAX_REQUESTSMaximum requests per rate limit windowOptional
RATE_LIMIT_WINDOW_MINUTESRate limit window in minutesOptional
TOOL_SEARCH_ENABLEDEnable FastMCP tool search transformOptional
TOOL_SEARCH_STRATEGYTool search strategy (bm25 or regex)Optional
TOOL_SEARCH_MAX_RESULTSMaximum tool search results returned by search_toolsOptional