Skip to content
appsgit

Mikrotik MCP

Mikrotik MCP is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH. It has 293 GitHub stars, is released under the MIT license and runs locally with uvx mcp-server-mikrotik.

github.com/jeff-nasseri/mikrotik-mcp (opens in a new tab)

  • Needs API key
  • Other
  • MIT
  • Actively maintained

Install Mikrotik MCP

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "mikrotik-mcp": {
      "command": "uvx",
      "args": [
        "mcp-server-mikrotik"
      ],
      "env": {
        "MIKROTIK_PASSWORD": "your-value",
        "MIKROTIK_INVENTORY": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env MIKROTIK_PASSWORD=your-value --env MIKROTIK_INVENTORY=your-value --transport stdio mikrotik-mcp -- uvx mcp-server-mikrotik

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "mikrotik-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-mikrotik"
      ],
      "env": {
        "MIKROTIK_PASSWORD": "your-value",
        "MIKROTIK_INVENTORY": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "mikrotik_password",
      "description": "MIKROTIK_PASSWORD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "mikrotik_inventory",
      "description": "MIKROTIK_INVENTORY",
      "password": true
    }
  ],
  "servers": {
    "mikrotik-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-mikrotik"
      ],
      "env": {
        "MIKROTIK_PASSWORD": "${input:mikrotik_password}",
        "MIKROTIK_INVENTORY": "${input:mikrotik_inventory}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
MIKROTIK_HOSTNoIP address or hostname of the MikroTik router (single-device mode; default: 127.0.0.1). Not needed when an inventory is configured.
MIKROTIK_USERNAMENoSSH username for the MikroTik router (single-device mode; default: admin)
MIKROTIK_PASSWORDsecretNoSSH password for the MikroTik router (single-device mode)
MIKROTIK_PORTNoSSH port of the MikroTik router (single-device mode; default: 22)
MIKROTIK_KEY_FILENAMENoPath to SSH private key file for key-based authentication (single-device mode)
MIKROTIK_READ_ONLYNoWhen true, expose only tools that do not modify RouterOS or its file store. Use a read-only RouterOS account as defence in depth.
MIKROTIK_SENSITIVE_HIDINGNoWhen true, redact recognized credentials and private key material from tool results, MCP notifications, and logs, and omit tools that return opaque sensitive…
MIKROTIK_INVENTORY_FILENoPath to a YAML file listing multiple MikroTik devices (title, host, port, username, password, key_filename, tags, region). See docs/reference/inventory.
MIKROTIK_INVENTORYsecretNoInline multi-device inventory as a YAML (or JSON) list; takes precedence over MIKROTIKINVENTORYFILE and the single-device variables. Holds credentials.

About Mikrotik MCP

MikroTik MCP provides a bridge between AI assistants and MikroTik RouterOS devices. It allows AI assistants to interact with MikroTik routers through natural language requests, executing commands like managing VLANs, configuring firewall rules, handling DNS settings, and more.

  • ai
  • ai-agents
  • ai-assistant
  • ai-tools
  • llms
  • mcp
  • mcp-server
  • mikrotik
  • model-context-protocol
  • networking

FAQ

Mikrotik MCP FAQ

Still curious? Email info@appsgit.com.

What is Mikrotik MCP?

Mikrotik MCP is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for MikroTik routers: firewall, NAT, routing, DHCP, DNS, WireGuard and more via SSH. It has 293 GitHub stars, is released under the MIT license and runs locally with uvx mcp-server-mikrotik. The source code is at github.com/jeff-nasseri/mikrotik-mcp.

How do I install the Mikrotik MCP MCP server?

Add the command uvx mcp-server-mikrotik to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Mikrotik MCP free?

The server is open source under the MIT license, so running it is free. It needs credentials (MIKROTIK_PASSWORD and MIKROTIK_INVENTORY) for the service it connects to, which may require a paid account.

Is Mikrotik MCP actively maintained?

The most recent commit was on Oct 3, 2026. The latest release is v0.24.0, published Oct 3, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.