Trello MCP Server

This project implements a Model Context Protocol (MCP) server that integrates with Trello using the Trello REST API. It allows MCP-compatible clients (like Cursor) to interact with Trello boards, cards, and labels.

---

✅ Features

The server provides the following MCP tools:

• listBoards – Get all boards for the authenticated user.
• createCard – Create a new card in a specified Trello list.
• addComment – Add a comment to a specific Trello card.
• moveCard – Move a card to a different list.
• deleteCard – Delete a Trello card.
• addLabel – Add a label to a Trello card.

---

🛠 Requirements

• Node.js (v18+ recommended)
• Cursor Editor with MCP enabled
• Trello API Key and Token (Get them here)

---

📦 Installation

1. Clone the repository:

   git clone https://github.com/your-username/trello-mcp-server.git
   cd trello-mcp-server

2. Install dependencies:

   npm install

---

🖥 Cursor MCP Configuration

Add this to your Cursor MCP config file (~/.cursor/mcp.json):

{
  "servers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-mcp/index.js"],
      "env": {
        "TRELLO_KEY": "your_trello_api_key",
        "TRELLO_TOKEN": "your_trello_token"
      }
    }
  }
}

Replace /absolute/path/to/trello-mcp/index.js with the actual path to your index.js file.

---

✅ Test the Tools in Cursor

Once added, restart Cursor and you can use the tools:

• List all boards:

  listBoards
  

• Create a card:

  createCard {
    "listId": "your_list_id",
    "name": "New Card from Cursor"
  }
  

• Add a comment:

  addComment {
    "cardId": "your_card_id",
    "text": "This is a test comment"
  }
  

---

🔍 How to Find listId and cardId

• Run:

  listBoards
  

  This returns all your boards and their IDs.
• Use Trello API or MCP tools to get lists inside a board.
• When creating a card, use the listId from the list you want.

---

🔧 Tools Overview

listBoards

Description: List all Trello boards. Input: None Output: JSON array of boards.

---

createCard

{
  "listId": "string",
  "name": "string"
}

---

addComment

{
  "cardId": "string",
  "text": "string"
}

---

moveCard

{
  "cardId": "string",
  "listId": "string"
}

---

deleteCard

{
  "cardId": "string"
}

---

addLabel

{
  "cardId": "string",
  "color": "string",
  "name": "string (optional)"
}

---

📚 References

• Cursor MCP Docs
• Trello API Docs
• Model Context Protocol