Meraki Magic Mcp Community

Meraki Magic MCP

Meraki Magic is a Python-based MCP (Model Context Protocol) server for Cisco's Meraki Dashboard. Meraki Magic provides tools for querying the Meraki Dashboard API to discover, monitor, and manage your Meraki environment.

Two Versions Available

🚀 Dynamic MCP (Recommended) - meraki-mcp-dynamic.py

• ~804 API endpoints automatically exposed
• 100% SDK coverage - all Meraki API methods available
• Auto-updates when you upgrade the Meraki SDK
• No manual coding required for new endpoints

📋 Manual MCP - meraki-mcp.py

• 40 curated endpoints with detailed schemas
• Type-safe with Pydantic validation
• Custom business logic for specific use cases
• Clean documentation for common operations

Features

Dynamic MCP includes:

• All organization management (admins, networks, devices, inventory, licensing)
• Complete wireless management (SSIDs, RF profiles, Air Marshal, analytics)
• Full switch management (ports, VLANs, stacks, QoS, access policies)
• Advanced appliance/security (all firewall types, NAT, VPN, traffic shaping)
• Camera management (analytics, quality, schedules, permissions)
• Network monitoring (events, alerts, health, performance)
• Live troubleshooting tools (ping, cable test, ARP table)
• Webhooks and automation (alert profiles, action batches)
• And 700+ more endpoints...

Manual MCP includes:

• Network discovery and management
• Device discovery and configuration
• Client discovery and policy management
• Wireless SSID management
• Switch port and VLAN configuration
• Basic firewall rules
• Camera settings

Quick Installation

Prerequisites

• Python 3.13+
• Claude Desktop (or any MCP-compatible client)
• Meraki Dashboard API Key
• Meraki Organization ID

Fast Track

macOS:

git clone https://github.com/CiscoDevNet/meraki-magic-mcp-community.git
cd meraki-magic-mcp-community
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env-example .env
# Edit .env with your API credentials

Windows (PowerShell):

git clone https://github.com/CiscoDevNet/meraki-magic-mcp-community.git
cd meraki-magic-mcp-community
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
copy .env-example .env
# Edit .env with your API credentials

📖 For detailed step-by-step instructions, see INSTALL.md

Configuration

Edit .env with your Meraki credentials:

MERAKI_API_KEY="your_api_key_here"
MERAKI_ORG_ID="your_org_id_here"
MERAKI_BASE_URL="https://api.meraki.com/api/v1"

# Optional: Performance tuning
ENABLE_CACHING=true
CACHE_TTL_SECONDS=300
READ_ONLY_MODE=true

Get your API key from: Meraki Dashboard → Organization → Settings → Dashboard API access

READ_ONLY_MODE defaults to true to block create/update/delete/remove operations. Set READ_ONLY_MODE=false only when you intend to make changes. Delete/remove calls also require confirm_destructive_action=true.

Use MERAKI_BASE_URL to point the MCP server at another Meraki region or compatible Dashboard API base URI.

Deployment Options

There are three ways to deploy Meraki Magic MCP:

Claude Desktop Setup

Dynamic MCP (Recommended)

1. Locate Claude config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Edit config with your paths:

macOS Example:

{
  "mcpServers": {
    "Meraki_Magic_MCP": {
      "command": "/path/to/meraki-magic-mcp-community/.venv/bin/fastmcp",
      "args": [
        "

... [View full README on GitHub](https://github.com/CiscoDevNet/meraki-magic-mcp-community#readme)