mikrotik-mcp

MCP server for Mikrotik

Install

uvx mcp-server-mikrotik

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

README.md

MikroTik MCP

Overview

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.

Demo Videos

Claude Desktop

https://github.com/user-attachments/assets/24fadcdc-c6a8-48ed-90ac-74baf8f94b59

Inspector

https://github.com/user-attachments/assets/e0301ff2-8144-4503-83d0-48589d95027d

Inventory

[!NOTE] Since MikroTik MCP version 0.14.0, the MikroTik MCP will allow you to manage multiple MikroTik devices within your fleet structure. The following video simply shows how to use the inventory of MikroTik devices to let LLMs talk with your MikroTik devices.

https://github.com/user-attachments/assets/185b2c39-8f55-4f26-a74c-2ac459ad38f5

Documentation

📚 Full Documentation - Complete guides, API reference, and examples

🌐 Prefer to read online? The same documentation is also published at www.mikrotik-mcp.com (docs) — an optional, web-friendly way to explore the project while reviewing the repo.

Quick Links

Installation Guide - Get started with MikroTik MCP
Testing Guide - Run integration tests
Claude Desktop Integration - Configure for Claude Desktop
MCP Inspector - Interactive testing tool
Contributing Guide - Help improve MikroTik MCP
Articles - Learning resources and tutorials
Diagrams - Architecture and design diagrams (draw.io)

Contributors ❤️

MikroTik MCP is built by the people below. Thank you for every commit, issue, review and idea.

Contributions of every kind are welcome: code, bug reports, documentation and reviews all move the project forward. Start with the Contributing Guide.

Community

Got a question, an idea, or something you'd like to talk through? Join us on Discord. Users and contributors are both welcome, whether you're connecting your first router or working on a PR.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.