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.

Related MCP server: Meraki Dashboard MCP Server

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.