Python API wrapper around Trello's API
Pull request Compare This branch is 310 commits behind sarumont:master.
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.


pip install py-trello


py-oauth2 works if you apply this patch. 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/


Adrien Lemaire