A simple GAE app that receives emails and POSTs them to a URL
Latest commit d87f6fe Mar 3, 2015 @capitao Added attachment support
Failed to load latest commit information.
README.md Added attachment support Mar 3, 2015
app.yaml Added attachment support Mar 3, 2015
main.py Added attachment support Mar 3, 2015


Bare Bones Receiver

This is a simple Google App Engine app that will receive emails and POST them to a url. It's a cheap and easy way to let your app receive emails without having to deal with email server madness.

How to use

There shouldn't be much setup to this, just change a thing or two and upload:

  • Fire up a new GAE app
  • Change the application in app.yaml to your app id
  • Change the url in main.py to your POST endpoint
  • Deploy!

Any emails following this format are received and forwarded to your specified endpoint: __________@<your-app-id>.appspotmail.com

Dont forget the appspot MAIL part! Otherwise it won't go through.

POST parameters

  • sender: sender's email address, e.g. Nobody <nobody@example.com>
  • to: comma separated list, e.g. Joe <joe@example.com>, Bill <bill@example.com>
  • cc: comma separated list like, may or may not exist
  • date
  • subject
  • html_body: may or may not exist
  • plain_body
  • attachments: a JSON list of any attachments, following this form:
    "filename": "filename.ext",
    "encoding": "base64",


  • You can define the email address(es) that will receive email in you app.yaml. The given configuration will match any email addresses at your appspotmail subdomain. See the docs if you want to define different / multiple handlers.

  • Google app engine has limits on request sizes (10mb request and 32mb response). If you are using this with attachments you might want to make sure you understand all of the quotas and limits on the platform.