# Mikrotik MCP (MCP server)

> 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.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/jeff-nasseri/mikrotik-mcp |
| GitHub stars | 293 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: mcp-server-mikrotik |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Other |
| Latest release | v0.24.0 (Oct 3, 2026) |
| Last commit | Oct 3, 2026 |
| MCP registry name | io.github.jeff-nasseri/mikrotik-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```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

```sh
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)

```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)

```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 2026-10-07.

## Environment variables

- `MIKROTIK_HOST`: IP address or hostname of the MikroTik router (single-device mode; default: 127.0.0.1). Not needed when an inventory is configured.
- `MIKROTIK_USERNAME`: SSH username for the MikroTik router (single-device mode; default: admin)
- `MIKROTIK_PASSWORD` (secret): SSH password for the MikroTik router (single-device mode)
- `MIKROTIK_PORT`: SSH port of the MikroTik router (single-device mode; default: 22)
- `MIKROTIK_KEY_FILENAME`: Path to SSH private key file for key-based authentication (single-device mode)
- `MIKROTIK_READ_ONLY`: When 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_HIDING`: When true, redact recognized credentials and private key material from tool results, MCP notifications, and logs, and omit tools that return opaque sensitive…
- `MIKROTIK_INVENTORY_FILE`: Path to a YAML file listing multiple MikroTik devices (title, host, port, username, password, key_filename, tags, region). See docs/reference/inventory.
- `MIKROTIK_INVENTORY` (secret): Inline multi-device inventory as a YAML (or JSON) list; takes precedence over MIKROTIKINVENTORYFILE and the single-device variables. Holds credentials.

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/mikrotik-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.