Trello MCP Server

🚀 Trello MCP Server

Trello MCP Server is a Trello server implementation based on the MCP protocol. It provides a way to interact with Trello using the MCP protocol, enabling users to manage boards, lists, cards, and more through command - line or other tools.

🚀 Quick Start

Trello is a popular online collaboration tool that allows users to create boards, lists, cards, and other project - management features. The MCP (Multi - Command Protocol) is a protocol for automation and script - driven operations, which enables interaction with Trello via the command line. The Trello MCP Server offers an MCP - based interface for users to interact with Trello, supporting a rich set of commands for creating, reading, updating, and deleting boards, lists, cards, as well as handling comments, attachments, and other related functions.

📦 Installation

To install the Trello MCP Server, follow these steps:

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. Start the server:

   node index.js
   

📚 Documentation

Configuration

The Trello MCP Server uses the configuration file config.json for settings. The default configuration is as follows:

{
  "port": 3000,
  "host": "localhost",
  "api_key": "",
  "token": ""
}

To configure the server, edit the config.json file before starting it.

Commands

The Trello MCP Server supports the following commands:

Board - related commands

• board create <name>: Create a new board.
• board list: List all boards.
• board delete <id>: Delete the specified board.
• board info <id>: Get information about the specified board.

List - related commands

• list create <board_id> <name>: Create a new list on the specified board.
• list list <board_id>: List all lists on the specified board.
• list delete <board_id> <list_id>: Delete the specified list on the specified board.

Card - related commands

• card create <board_id> <list_id> <name>: Create a new card on the specified list.
• card list <board_id> <list_id>: List all cards on the specified list.
• card delete <card_id>: Delete the specified card.

Comment - related commands

• comment add <card_id> <text>: Add a comment to the specified card.
• comment list <card_id>: List all comments on the specified card.

💻 Usage Examples

Basic Usage

Here is an example of using the Trello MCP Server:

# Create a new board
board create "My Project"

# Create a list on the new board
list create <new_board_id> "To Do"

# Create a card on the "To Do" list
card create <new_board_id> <to_do_list_id> "Complete Setup"

# Add a comment to the specified card
comment add <card_id> "Great, let's start working!"

🔧 Technical Details

The code structure of the Trello MCP Server is as follows:

trello-mcp-server/
├── index.js          # Main program entry
├── config.json       # Configuration file
└── commands/         # Command - handling modules
    ├── board.js     # Board - related command handling
    ├── list.js      # List - related command handling
    └── card.js      # Card - related command handling

🤝 Contribution Guide

If you want to contribute to the Trello MCP Server, follow these steps:

1. Clone the repository:

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

2. Create a feature branch:

   git checkout -b feature/<your-feature>
   

3. Commit your changes:

   git add .
   git commit -m "Add new feature"
   

4. Push to the remote repository and create a pull request.

📄 License

The Trello MCP Server is licensed under the MIT License.

📞 Contact

If you have any questions or suggestions, please contact Vlad Herus.