Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A python Google Voice notification client

branch: master
GoogleVoiceNotify polls the Google Voice XML pages (, and sends notifications to any number of registered listeners.

At the moment, the Notifier only supports SMS notifications, but adding voicemail, missed calls, etc, is just a matter of writing scrapers for those as well.

1. BeautifulSoup (
2. prowlpy ( (which also has its own dependencies such as httplib2)

I've also included a sample client for GoogleVoiceNotify that sends notifications to Prowl (, which sends iPhone push notifications.

To use the Prowl listener, you need to create two files in your home directory.
~/.prowlapi (should just contain your Prowl API key)
(optionally) ~/.gvnotify (a config file that should look as follows):
sleep=sleeptime (in seconds)

If you don't make a credentials file, then the script will prompt you for a username/password on the command line and default to 60 seconds.

then just do:


in the same folder where the, files are.

I've also included a bash script that launches/controls the notifier, written by James Bair (in tools/ and a Python daemon written by Brian Baughman (in tools/


from googlevoicenotify import GoogleVoiceNotify
gv = GoogleVoiceNotify('username', 'password')

Though you'll probably want to register at least one listener:

class PrintListener(object):
	def on_notification(self, event, name, message):
		print "(%s) %s said %s" % (event, name, message)

from googlevoicenotify import GoogleVoiceNotify
import time
print_listener = PrintListener()
gv = GoogleVoiceNotify('your_username', 'your_password', listeners=print_listener)
while True:

Something went wrong with that request. Please try again.