Cisco Meraki Home Assistant Integration 🏠☁️

Welcome to the Cisco Meraki Home Assistant Integration! This project bridges the gap between your Cisco Meraki cloud-managed network and your local Home Assistant instance. Whether you're managing a home lab, a small business, or just love having total control over your network gear, this integration has you covered.

Note: This is currently in Beta. We're moving fast and improving stability, so feedback is always welcome!

Table of contents

• Key features
• Installation
• Configuration
• Web UI
• Services & controls
  • Parental controls (client blocking)
  • Content filtering
  • SSID control
• Entities
  • Device & entity model
  • Organization-wide sensors
  • Camera entities & sensors
  • Physical device sensors
  • Network sensors
  • VLAN sensors
  • Appliance port sensors
  • SSID sensors
  • Environmental sensors (MT series)
• Automation examples
• Troubleshooting
• How to contribute
• Known issues & limitations
• Disclaimer

Screenshots 📸

Network View	Device Detail View

Key features ✨

• Comprehensive Monitoring: Keep tabs on all your Cisco Meraki hardware, including Wireless Access Points (MR/GR), Switches (MS/GS), Security Appliances (MX), Cameras (MV), and Environmental Sensors (MT/MT40).
• Powerful Controls: Enable/disable SSIDs, block specific clients (Parental Controls), manage content filtering, and control MT40 smart power outlets.
• Guest Wi-Fi (IPSK) Management: Create, manage, and revoke temporary guest Wi-Fi keys directly from the dedicated Cisco Meraki Panel.
• Advanced Network Management: Toggle Site-to-Site VPN settings, manage Layer 3 firewall rules, and configure bandwidth limits (Traffic Shaping) per SSID.
• Enhanced Cisco Meraki Panel: A redesigned dedicated web interface for advanced features, real-time device monitoring, and event logs.
• Rich Sensor Data: Creates a wide array of sensors for device status, client counts, data usage, firmware updates, PoE consumption, and uplink metrics (latency, jitter, packet loss).
• Camera Integration: View live RTSP streams and MV Sense analytics from your Cisco Meraki cameras within Home Assistant.
• Custom Lovelace Cards: Includes a meraki-network-vitals-card for a quick glance at your network health and throughput. Note: The Cisco Meraki API does not expose real-time bandwidth metrics, so the throughput component of this card relies on an external speedtest integration (e.g., sensor.speedtest_download).

Enabling Identity PSK (Crucial Step)

To use the Guest Access feature, your target SSID must be configured to support multiple passwords. By default, most SSIDs use a single "Pre-shared key" (PSK), which does not allow Home Assistant to generate unique, temporary keys for guests.

Follow these steps to enable Identity PSK (IPSK) safely:

1. Log in to your Meraki Dashboard.
2. Navigate to Wireless > Configure > Access control.
3. Select the SSID you want to use for guest access.
4. Under Security, change the setting to Identity PSK without RADIUS.
5. CRITICAL (Don't skip!): To ensure your existing devices do not lose their connection, you must re-add your current Wi-Fi password as an Identity PSK:
   • Scroll down to the Identity PSK section.
   • Click Add an Identity PSK.
   • Name: Enter "Default Password" or similar.
   • Passphrase: Enter your current Wi-Fi password exactly as it is now.
   • Group policy: Select "None" (or your preferred default policy).
   • Click Save Changes.
6. Once saved, Home Assistant will now be able to dynamically add and remove new guest keys to this SSID without affecting your existing devices.

Automation examples 🚀

The integration includes pre-built Blueprints to simplify common automations. These are automatically discovered by Home Assistant and can be found under Settings > Automations & Scenes > Blueprints.

Available blueprints in automation/meraki/:

• Cisco Meraki Guest Wi-Fi Creator: Automatically creates a temporary Guest Wi-Fi key (IPSK) when a trigger entity is activated.
• Scheduled Cisco Meraki Content Filter: Automatically switch Cisco Meraki Content Filtering profiles based on a schedule.

Troubleshooting

If you encounter issues with the integration, please check the following:

• API Key and Organization ID: Ensure that your API key and organization ID are correct.
• API Access: Make sure that API access is enabled in your Cisco Meraki dashboard.
• Home Assistant Logs: Check the Home Assistant logs for any error messages related to the integration.
• Restart Home Assistant: If you've made any changes to the integration's configuration, restart Home Assistant to apply them.

---

Built with ❤️ by the Open Source Community.