Cisco Meraki Integration v2.0

Share your Projects! Custom Integrations
1

:rocket: Meraki Integration v2.0.0: The Re-Launch! :rocket:

Hi everyone! I’m thrilled to release version 2.0.0 of the Meraki integration for Home Assistant. This is a massive update, completely re-architected from the ground up to be faster, more powerful, and easier to use.

This release is more than just an update; it’s a relaunch. It addresses key community feedback [1], builds a new foundation for future growth, and (most importantly) unlocks a ton of new automation possibilities.

:warning: BIG BREAKING CHANGES: PLEASE READ FIRST! :warning:

Version 2.0.0 introduces a completely new setup process!

To support all the new features and to align with the latest Home Assistant standards [2, 3], I’ve completely rebuilt the configuration flow. This makes the integration more robust, secure, and easier to manage.

Because this new setup is so different, it is not compatible with the old one.

You MUST migrate your setup. Your existing integration setup will not transfer automatically.

How to Migrate (Step-by-Step):

  1. BACKUP YOUR SYSTEM! :shield: Seriously. Create a Home Assistant backup right now.
  2. Go to Settings -> Devices & Services.
  3. Find your existing “Meraki” integration and click the three-dot menu.
  4. Select Delete and confirm.
  5. Restart Home Assistant (a full restart, not just a config reload). This is important to clear the old configuration.
  6. Go back to Settings -> Devices & Services.
  7. Click the [+] Add Integration button in the bottom-right.
  8. Search for “Meraki” and select it.
  9. Follow the new setup prompts in the UI. You will be asked for your Meraki API Key.
  10. That’s it! The integration will set itself up with the new configuration.

A NOTE ON ENTITY IDs: This migration may cause some of your entity IDs to change. If your automations or dashboards break, please check the entity IDs in Developer Tools and update them. I have made every effort to ensure unique_ids are stable to prevent this, but it’s always best to check. Thank you for your understanding!

:package: How to Get It

This integration is available through HACS (Home Assistant Community Store). Click the badge below to be taken directly to the repository within your own Home Assistant instance for easy installation:

(https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=brewmarsh&repository=meraki-homeassistant&category=integration)

:rocket: What’s New: The Headline Features

:gear: New & Improved Setup (Config Flow)

As mentioned above, the entire setup process has been rebuilt.[3] This new UI-based flow [2, 3] is more reliable and provides the foundation for all the new features in 2.0.0!

:desktop_computer: New Meraki Side Panel!

V2.0.0 introduces a dedicated Meraki panel in your Home Assistant sidebar!

  • User Value: This gives you a central hub to view the status of all your Meraki devices at a glance without having to build a custom dashboard from scratch.

:crescent_moon: “Scheduled Access” is Here! (SSID Control)

You asked, I listened! You can now control your SSIDs as simple switch entities in Home Assistant.

  • User Value: Automatically turn off the Kids_Wifi SSID at 9 PM. Create a “Guest Mode” button in your dashboard that enables the Guest_Wifi for 4 hours. The power is yours!
  • switch.meraki_my_network_kids_wifi
  • switch.meraki_my_network_guest_wifi

:chart_with_upwards_trend: “Guest Analytics” Sensors

Ever wonder how many people are on your guest network? Now you can see it right in Home Assistant. This release adds new sensors for:

  • User Value: Track guest network usage over time.
  • sensor.meraki_my_network_guest_wifi_client_count
  • sensor.meraki_my_network_guest_wifi_data_usage

:dash: Faster, More Efficient Polling!

V2.0.0 includes a completely refactored polling engine. This significantly reduces API calls, improves performance, and makes the integration more reliable, especially on large networks.

:electric_plug: Switch Port Control!

This has been a popular request! [4] You can now control your MS-series switch ports directly.

  • User Value: Create automations to power-cycle a finicky PoE camera (switch.meraki_port_poe_control). Enable or disable ports on a schedule (switch.meraki_port_enabled).

:camera_flash: And Don’t Forget: RTSP Camera Support!

  • User Value: Just a reminder that this integration still provides full RTSP camera streams and snapshot support for your MV cameras, a unique feature!

:hammer_and_wrench: The Full Changelog

(You can paste your more granular commit list here. These are the main categories.)

:sparkles: Features

  • Added a new side panel for a high-level overview of your Meraki network.
  • Added switch entities for SSID control.
  • Added new sensor entities for guest analytics.
  • Added switch entities for MS switch port PoE and status.

:wrench: Enhancements

  • Completely rebuilt the integration setup process (Config Flow) for reliability and future-proofing.
  • Refactored API polling to reduce API calls and improve performance.
  • Added unique_id to all entities for better reliability and UI control.
  • Improved error handling for Meraki API rate limits.

:bug: Bug Fixes

  • (Add your specific bug fixes here)

:heart: Acknowledgements & Future Plans

A huge thank you to everyone who filed issues, tested, and provided feedback!

What’s next? The original roadmap is now complete! But I’m not stopping. I’m always looking at new Meraki API features to pull in. My focus for v2.x/v3.0 will be on:

  • Expanding support for all MT environmental sensors
  • Adding device tracker entities for clients
  • Deeper integration with MV camera alerts

Please keep the feedback coming! If you love this integration, consider giving the GitHub repo a star :star2:.

1 Like