MCP Server Trello

🚀 MCP Server - Trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server automatically handles rate limits, type safety, and error handling when integrating with Trello's API.

✨ Features

• Full Trello Board Integration: Interact with cards, lists, and board activities.
• Built-in Rate Limiting: Respect Trello's API limits (300 requests per 10 seconds per API key, 100 requests per 10 seconds per token).
• Type-Safe Implementation: Written in TypeScript with comprehensive type definitions.
• Input Validation: Robust validation for all API inputs.
• Error Handling: Graceful error handling with detailed messages.

📦 Installation

npm install @modelcontextprotocol/mcp-server-trello

Configuration

Add the server to your MCP settings file as follows:

{
  "mcpServers": {
    "trello": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-trello"],
      "env": {
        "TRELLO_API_KEY": "your-api-key", // Your Trello API key
        "TRELLO_TOKEN": "your-token",     // Your Trello token
        "TRELLO_BOARD_ID": "your-board-id" // Configured Trello board ID
      }
    }
  }
}

💻 Usage Examples

Basic Usage

Get Board Information

// Get basic information about a specified board
const board = await trello.getBoard(boardId);
// Return value: An object containing information such as board name, description, and members

Create a New List

// Create a new list on a specified board
const newList = await trello.createList(boardId, "Task List");

Add a Card to a List

// Add a card to a specified list
const card = await trello.addCardToList(listId, "Complete the project");

Advanced Usage

There are no advanced usage examples provided in the original document.

Rate Limiting

The server processes a maximum of 50 requests per minute to prevent abuse and ensure stability.

Error Handling

All API calls come with a retry mechanism (up to 3 times) and log error messages in case of failure.

Development Information

Clone the Repository

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

Install Dependencies

npm install

Build the Project

npm run build

Run Tests

npm test

Contribution Guidelines

Contributions are welcome! Please read our Chinese Contribution Guidelines for code specifications and the process of submitting a Pull Request.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

• Uses the Model Context Protocol SDK
• Built on the Trello REST API