Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Python API wrapper around Trello's API
Tag: 0.1.0

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

A wrapper around the Trello API written in Python. Each Trello object is represented by a corresponding Python object. The attributes of these objects are cached, but the child objects are not. This can possibly be improved when the API allows for notification subscriptions; this would allow caching (assuming a connection was available to invalidate the cache as appropriate).

I've created a Trello Board for feature requests, discussion and some development tracking. It can be found here


pip install py-trello


py-oauth2 works if you apply the patch found here. To use 3-legged authentication, construct your Trello client as follows:

client = Trello(api_key = '...', api_secret = '...', token = '...', token_secret = '...')

Where token and token_secret come from the 3-legged OAuth process. api_key and api_secret are your Trello API credentials (generated here.

Required Python modules


To run the tests, run python Three environment variables must be set:

  • TRELLO_API_KEY: your Trello API key
  • TRELLO_TOKEN: your Trello OAuth token
  • TRELLO_TEST_BOARD_COUNT: the number of boards in your Trello account
  • TRELLO_TEST_BOARD_NAME: name of the board to test card manipulation on. Must be unique, or the first match will be used

And run (from py-trello/):

PYTHONPATH=. python test/
Something went wrong with that request. Please try again.