Skip to main content

Notifications via Google Calendar Nagios plugin

Project description

nagios-notification-google-calendar is a Nagios-plugin that send Nagios notifications via google calendar SMS reminder


Google disable SMS notifications for calendar events after June 27, 2015. Therefore after this date this plugin useless.


  • Obtain your copy of source code from git repository: git clone Or download latest release from

  • Run python ./ install from repository source tree or unpacked archive under root user. Or use pip: pip install nagios-notification-google-calendar.


  • Read and understand Nagios documentation.

  • Create Nagios commands definitions like this:

# "host-notify-by-sms" command
define command{
    command_name    notify-host-by-sms
    command_line    /usr/bin/ -u $CONTACTNAME$ -m "Host '$HOSTALIAS$' is $HOSTSTATE$ - Info: $HOSTOUTPUT$" -C $CONTACTADDRESS1$ -t $CONTACTADDRESS2$

# "service-notify-by-sms" command
define command{
    command_name    notify-by-sms
  • Go to and create new project.

  • Enable calendar API for project.

  • Create an OAuth 2.0 client ID for project with Installed application type and download JSON client secrets file.

  • Copy /usr/share/doc/nagios-notification-google-calendar/notification_google_calendar.ini to /etc/nagios with your settings. Attention: nagios user must have notification_google_calendar.ini read permissions, and credentials directory read/write permissions.

  • Modify contacts definitions:
    • Add addressX option to contact definition with contact google calendar ID.

    • Add addressX option to contact definition with contact preferred timezone (in human readable format from TZ database). This is dirty hack, but i don’t know how do this better way.

    • Get and save credentials by run -g -u USERNAME where USERNAME - nagios contact name.

    • Add commands to the lists of service and host notifications commands for contact.

    • Configure google calendar for mobile devices.


nagios-notification-google-calendar is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. For complete license text see COPYING file.


Project Website:

Author: Alexei Andrushievich <>

For other authors list see AUTHORS file.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page