Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Python API wrapper for the Simplenote web service
Failed to load latest commit information.
docs Update doc index to show optional args for get_note and get_note_list
simplenote Bump version to 0.4.0 (Python 2 and 3 compatibility)
tests Remove temporary comments from test suite
.gitignore update gitignore
.travis.yml Add Python 3.4 to Travis testing
HISTORY.rst Bump version to 0.4.0 (Python 2 and 3 compatibility)
LICENSE create basic project layout
MANIFEST create basic project layout create basic project layout
README.rst Extends get_note_list to fetch a list of notes with a certain tag


Introduction is a python library for the web service.


Install via pip:

pip install simplenote

Or if you must:

easy_install simplenote

Usage can be imported into any python module:

from simplenote import Simplenote
simplenote = Simplenote(user, password)

The object then provides the following API methods:

simplenote.get_note_list(since=YYYY-MM-DD, tags=[])     # Supports optional `since` parameter that takes "YYYY-MM-DD"
                                                        # date string to return only notes modified since this date.
                                                        # Supports optional `tags` parameter that takes a list of tags
                                                        # to return only notes that contain at least one of these tags.

simplenote.get_note(note_id)                            # note id is value of key `key` in note dict as returned
                                                        # by get_note_list. Supports optional version integer as
                                                        # argument to return previous versions

simplenote.add_note(note)                               # A ``note`` object is a dictionary with at least a
                                                        # ``content`` property, containing the note text.

simplenote.update_note(note)                            # The ``update_note`` method needs a note object which
                                                        # also has a ``key`` property.




If you want to contribute:

  • Fork the project.
  • Make your feature addition or bug fix based on master.
  • Add tests for it. This is important so I don’t break it in a future version unintentionally.
  • Commit, do not mess with version
  • Send me a pull request. Bonus points for topic branches.
Something went wrong with that request. Please try again.