Skip to main content

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

Download files

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

Files for python-guerrillamail, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size python_guerrillamail-0.2.0-py2.py3-none-any.whl (8.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size python-guerrillamail-0.2.0.tar.gz (5.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page