Cisco Meraki MCP Server

Overview

The Cisco Meraki MCP Server is a Python-based implementation of the Model Context Protocol (MCP) that exposes Cisco Meraki Dashboard API operations as MCP tools.

Instead of calling REST APIs directly, any MCP-compatible client can invoke these tools using a standardized interface.

This project demonstrates how MCP can be used to bridge AI assistants and enterprise networking platforms.

---

Features

• Cisco Meraki Dashboard API integration
• Model Context Protocol (MCP) Server
• Streamable HTTP transport
• Environment variable support
• Interactive MCP client
• Clean and modular Python code
• Production-ready project structure
• Easy to extend with additional Meraki APIs

---

Supported Tools

Health

• Health Check

---

Networks

• Create Network
• Delete Network
• List Networks
• Get Network Information

---

Configuration Templates

• Create Template
• List Templates
• Get Template Information
• Bind Template to Network

---

Project Structure

meraki-mcp/
│
├── app.py                 # MCP Server
├── client.py              # Interactive MCP Client
├── meraki.py              # Cisco Meraki REST API Wrapper
├── config.py              # Configuration & Environment Variables
├── requirements.txt
├── README.md
├── .env

---

Requirements

• Python 3.10 or later
• Cisco Meraki Dashboard Account
• Cisco Meraki API Key

---

Installation

Clone the repository.

git clone <repository-url>

Move into the project directory.

cd meraki-mcp

Install the required packages.

pip install -r requirements.txt

---

Environment Variables

Create a .env file in the project directory (or copy .env.example to .env).

Example:

# Cisco Meraki Dashboard API Key
MERAKI_API_KEY=YOUR_MERAKI_API_KEY

# OpenAI API Key
# Required only if using the AI-powered client.
OPENAI_API_KEY=YOUR_OPENAI_API_KEY

Note:

• MERAKI_API_KEY is required to authenticate with the Cisco Meraki Dashboard API.
• OPENAI_API_KEY is only required if you are using the AI-powered client that converts natural language into MCP tool calls.

---

Running the MCP Server

Start the server.

python app.py

If successful, you should see output similar to:

Connected to Cisco Meraki Dashboard
Organization ID : xxxxxxx

Cisco Meraki MCP Server Started

---

Running the Interactive Client

Open another terminal.

Run:

python client.py

Example:

============================================================
Cisco Meraki Natural Language MCP Client
============================================================

Connected Successfully.

You >

---

Supported Natural Language Commands

Health

Health check
Check health
Check server health
Server status
Status

---

Networks

Show all networks
List all networks
List networks

Create a network named Delhi Office
Create network Delhi Office

Delete network Delhi Office
Remove network Delhi Office

Show network Delhi Office
Get network Delhi Office
Show information for Delhi Office

---

Templates

List templates
Show templates

Create a template named Branch Template
Create template Branch Template

Show template Branch Template
Get template Branch Template

Bind template Branch Template to Delhi Office
Apply template Branch Template to Delhi Office

---

Other Commands

Help

Exit

---

Example Session

You > Show all networks

Result
------------------------------------------------------------
[
    {
        "id": "...",
        "name": "Delhi Office"
    }
]

You > Create a network named Mumbai Office

Result
------------------------------------------------------------
Network created successfully.

You > List templates

Result
------------------------------------------------------------
...

You > Exit

---

Current Architecture

+-----------------------------+
| Interactive Client          |
| (client.py)                 |
+-------------+---------------+
              |
              |
              v
+-----------------------------+
| MCP Server                  |
| (app.py)                    |
+-------------+---------------+
              |
              |
              v
+-----------------------------+
| Cisco Meraki REST Wrapper   |
| (meraki.py)                 |
+-------------+---------------+
              |
              |
              v
+-----------------------------+
| Cisco Meraki Dashboard API  |
+-----------------------------+

---

Technology Stack

• Python
• Model Context Protocol (MCP)
• FastMCP
• Cisco Meraki Dashboard API
• Requests
• Python Dotenv
• Uvicorn

---

Future Enhancements

• VLAN Management
• Switch Port Configuration
• Wireless SSID Management
• Firewall Rules
• Device Inventory
• Client Information
• Organization Administration
• OpenAI Integration for intelligent natural language understanding
• Multi-Organization Support
• Logging
• Unit Testing
• Docker Support
• GitHub Actions CI/CD

---

Troubleshooting

Invalid API Key

Ensure the .env file contains a valid Cisco Meraki API key.

---

Network Not Found

Verify that the specified network exists in your Cisco Meraki Dashboard.

---

Template Not Found

Verify that the template exists before attempting to retrieve or bind it.

---

Connection Errors

Ensure the MCP server is running before starting the client.

---

Learning Objectives

This project demonstrates:

• Building an MCP Server from scratch
• Creating custom MCP tools
• Calling enterprise REST APIs
• Environment variable management
• Python project organization
• Interactive MCP client development
• Cisco Meraki Dashboard API automation

---

Author

Diwakar Sharma

Python Developer | Network Automation | AI | Cisco Meraki | MCP | REST APIs

---

License

This project is provided for educational purposes. Modify and extend it according to your own requirements.