node package manager


This module provides an easy way to make requests to the Trello API.


A simple asynchronous client for Trello

This is a wrapper for some of the Trello HTTP API. Please feel free to add any other pieces you need! :)

npm install trello

First, generate your Trello application key like this, then follow these confusing instructions to get a user token. These need to be supplied when you create the Trello object (see below).

  var Trello = require("trello");
  var trello = new Trello("MY APPLICATION KEY", "MY USER TOKEN");
  trello.addCard('Clean car', 'Wax on, wax off', myListId,
      function (error, trelloCard) {
          if (error) {
              console.log('Could not add card:', error);
          else {
              console.log('Added card:', trelloCard);

API calls can either execute a callback or return a promise. To return a promise just omit the callback parameter.

  trello.getCardsOnList(listId, callback);
  var cardsPromise = trello.getCardsOnList(listId);
  cardsPromise.then((cards) => {
    //do stuff 
  • added renameList
  • added addChecklistToCard
  • added getChecklistsOnCard
  • added addExistingChecklistToCard
  • added updateChecklist
  • added getOrgMembers
  • API methods now return the promise
  • Support of promises
  • Basic support of Labeling:
    • getLabelsForBoard
    • addLabelOnBoard
    • deleteLabel
    • addLabelToCard
    • deleteLabelFromCard
  • Updated dev dependencies
  • One-time listener
  • addAttachmentToCard added
  • Updated restler dependency
  • Node.js support >= 0.10.x / removed 0.6 and 0.8
  • Project trello_ex merged again with original project trello
  • Using 'restler' again
  • getBoards added