Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Python API wrapper for the Simplenote web service

Merge pull request #15 from muxueqz/master

Update API urls away from old appspot addresses

Note: the old API urls do still work at the time of committing, but it does make sense to update to the preferred ones.
latest commit 00acf66d26
@atomicules atomicules authored
Failed to load latest commit information.
docs Update doc index to show optional args for get_note and get_note_list
simplenote update service url
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 add simplejson as requirement for python < 2.6


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.