M0xai Trello MCP Server

🚀 Trello MCP Server

A powerful Multi-Protocol Client Server (MCP) for interacting with Trello's boards, lists, and cards through an AI host.

🚀 Quick Start

The Trello MCP Server is a robust solution that enables seamless interaction with Trello's boards, lists, and cards via an AI host. Below are the steps to get you started.

✨ Features

Overall Functionality

Detailed Functionality

Board Operations

• ✅ Read all boards
• ✅ Read detailed information of a specific board

List Operations

• ✅ Read all lists in a board
• ✅ Read detailed information of a specific list
• ✅ Create a new list
• ✅ Update the list name
• ✅ Archive (delete) a list

Card Operations

• ✅ Read all cards in a list
• ✅ Read detailed information of a specific card
• ✅ Create a new card in a list
• ✅ Update card attributes
• ✅ Delete a card

📦 Installation

Prerequisites

1. Python 3.12 or higher, easily managed via uv
2. Claude for Desktop installed
3. A Trello account and API credentials
4. uv package manager installed

Preparation Before Installation

1. Ensure the Claude desktop application is installed.
2. Make sure you are logged into Claude with your account.
3. Launch Claude.

Installation Steps

1. Set up Trello API credentials:

   • Go to Trello Apps Administration.
   • Create a new integration at New Power-Up or Integration.
   • Fill in the relevant information (you can leave the Iframe connection URL blank) and ensure the correct Workspace is selected.
   • Click on your application icon and navigate to "API key" from the left sidebar.
   • Copy the "TRELLO_API_KEY" you just obtained, and on the right: click the word "token" to get your Trello Token.

2. Rename the .env.example file in the project root directory to .env and set the variables:

TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here

3. Install uv if it's not already installed:

curl -LsSf https://astral.sh/uv/install.sh | sh

4. Clone this repository:

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

5. Use uv to install dependencies and set up the Claude server:

uv run mcp install main.py

6. Restart the Claude desktop application.

💻 Usage Examples

Basic Usage

After installation, you can interact with your Trello boards through Claude. Here are some example queries:

• "Show all my boards"
• "What are the lists in [Board Name]?"
• "Create a new card in [List Name]"
• "Update the details of [Card Name]"
• "Delete [Card Name]"

📚 Documentation

Troubleshooting

If you encounter issues, please check the following:

1. Ensure all dependencies are correctly installed.
2. Verify that your API credentials are valid.
3. Check the console for error messages.
4. If the problem persists, refer to the documentation or contact the support team.

Contribution

Contributions are welcome! Please refer to CONTRIBUTING.md to learn how to participate.