Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Client for the Guerrillamail temporary email server

Project description

Python Guerrillamail is a Python client API and command line interface for interacting with a Guerrillamail temporary email server.

Build Status


pip install python-guerrillamail

Example Usage

Create session using auto-assigned email address, print email address and print id of first message in inbox:

from guerrillamail import GuerrillaMailSession
session = GuerrillaMailSession()
print session.get_session_state()['email_address']
print session.get_email_list()[0].guid

Example CLI Usage

Set email address:

$ guerrillamail setaddr john.doe
$ guerrillamail info

List inbox contents:

$ guerrillamail list
(*) 48859781  23:45:27+00:00
Example messsage 2

(*) 48859574  09:25:01+00:00
Example message

( ) 1         00:00:00+00:00
Welcome to Guerrilla Mail

Read email message:

$ guerrillamail get 48859781
Date: 2016-06-11 23:45:27+00:00
Subject: Example message 2

Example Guerrillamail message body.

Using Alternative Guerrillamail Server

By default, is used as the base URL for Guerrillamail API calls. This can be overridden by providing the base_url property when constructing a GuerrillaMailSession instance. When using the CLI the base_url property can be defined in the ~/.guerrillamail JSON config file, for example:

    "base_url": ""


Python Guerrilla Mail is free software, licensed under the GPLv3.

Change History


  • Add support for Python 3.3, 3.4 and 3.5.
  • Add “guerrillamail” executable.


  • Fix mail “excerpt” property.


  • Remove version restriction on Requests dependency.


  • Initial release.

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
python_guerrillamail-0.2.0-py2.py3-none-any.whl (8.2 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Jun 12, 2016
python-guerrillamail-0.2.0.tar.gz (5.9 kB) Copy SHA256 hash SHA256 Source None Jun 12, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page