msnlib - a Python MSN messenger protocol library and client

msnlib logo - Greta Cubana Note: Microsoft is shutting down MSN messenger on March 2013. msnlib will cease to work and will no longer be maintained.

Please consider moving to Jabber (also known as XMPP). If you use gmail, you're already using it. Otherwise here is a list of jabber providers.


This is an opensource Python implementation for the MSN messenger protocol version 8.

It comes with a text-mode client named msn, which has a simple line-oriented user interface that resembles climm (previously called micq), and a base is a library (called msnlib), which uses a non-blocking callback scheme.

If you are intrested, a brief feature list is available, along with some screenshots.

Everything is licensed under the MIT license.

It's written in Python and works under any Unix environment (Linux, *BSD, etc.). The library has been tested and reported to work successfuly also under Microsoft Windows. For more information about the library itself, please read the README file.


The current version is 3.8 (released on 2011-05-15): You can also browse all released files.

Patches are welcome. The source code is managed using git. You can browse the repository, or clone it by running:

git clone git://

Clients using the library

msncp, a client written using ncurses.

I'MFish, a very interesting multi-protocol IM which presents a GUI (GTK based) interface like a fishbowl where all users are fish. For more information you can contact its author, Alejandro David Weil, at

msnmago lets you control your computer remotely through MSN.

mrcoffee is an MSN bot used to notify the office about coffee in progress.

ichatbot is an MSN chatbot that uses AIML, written by Hui Chen.

If you know of any other, please let me know so I can add it to the list.

Alberto Bertogli ( - Last updated 09/Mar/2013