Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A simple Python script for downloading your sent and received OkCupid messages to a text file.
Python Shell
branch: master

Merge pull request #27 from joelpurra/autologin-link

Alternative login method "autologin link"
latest commit e20bde842f
@lehrblogger authored



A script for downloading your sent and received OkCupid messages to a text file.


Requires python2.7, virtualenv and pip. To use it, run it from the command line like this:

okcmd -u your_username -p your_password -f 'output_message_file.txt'


You can add the -t flag to get the output as a possibly-Thunderbird-compatible file rather than the default plaintext format, but I haven’t really tested this. Put the file in a Local folder, and hopefully Thunderbird can read/process it from there. Let me know if it works!

Advanced usage

--autologin can be used instead of --password. Supply it with a link that will automatically log you in to OkCupid; you can find these links in emails sent to you from Okcupid. One example is the logotype in top/new matches emails – right click and choose “copy link”, then use it with the --autologin argument.

--debug shows a lot more output.

The okcmd command uses python2.7 and wraps execution in a virtual environment installed using virtualenv and pip. If that doesn’t work for you, try running python directly.


The time has come to deactivate my OkCupid account, but I was slightly unhappy about leaving all my messages in a locked silo, as they contained a nontrivial amount of emotionally significant correspondence. I googled around a bit for scripts that other people had written to do download them, and found one written for Greasemonkey and another written in Java, but neither seemed to be recent enough to be able to handle the current OkC HTML. I strongly prefer the BeautifulSoup Python library for dealing with HTML, so decided to write my own instead of modifying either of those.

Find it here! Use it quickly to download and archive your own messages! I probably won’t update it as the site updates, but feel free to send a pull request :)

Related projects

If you are interested in this project, chances are that the following project(s) might also be worth a look.

OkCupid-Message-Downloader © 2011, 2012, 2013, 2014, 2015 Steven Lehrburger (@lehrblogger). Released under the MIT license.

Something went wrong with that request. Please try again.