🚀 Trello MCP Server (TypeScript)

A Model Context Protocol (MCP) server integrated with Trello, implemented in TypeScript. It provides tools for AI assistants to interact with Trello boards, lists, and cards.

🚀 Quick Start

This Trello MCP Server allows AI assistants to interact with Trello boards, lists, and cards. Follow the steps below to get started.

✨ Features

Complete Trello API integration through MCP tools.
Asynchronous operations for better performance.
Type safety with TypeScript implementation.
Comprehensive error handling.
Environment based on configuration.

📦 Installation

Prerequisites

Node.js 18.x or higher.
npm or yarn.
Trello API credentials.

Steps

# Install dependencies
make install

📚 Documentation

Configuration

Create a .env file in the project root directory and add your Trello credentials:

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

Available Commands

# Install dependencies
make install

# Build the project
make build

# Start the server
make start

# Clean build artifacts
make clean

# Run code linting tool
make lint

MCP Tools

get_boards

Retrieve all Trello boards of the authenticated user.

// No input parameters required

get_lists

Get all lists from a specified board.

{
  "request": {
    "board_id": string // Board ID
  }
}

get_cards

Get cards from a board or a specific list.

{
  "request": {
    "board_id": string,    // Board ID
    "list_id"?: string     // Optional: ID of a specific list
  }
}

get_card_details

Retrieve detailed information of a specific card.

{
  "request": {
    "card_id": string      // Card ID
  }
}

Development

This project uses TypeScript for type safety and a better developer experience. The source code is organized as follows:

src/index.ts - The main entry point of the server.
src/trello-client.ts - Implementation of the Trello API client.
src/types.ts - TypeScript type definitions.

Build

This project is built using the TypeScript compiler:

# Build the project
make build

# The output will be in the build/ directory

Error Handling

The server implements comprehensive error handling, including:

API authentication errors.
Rate limits.
Network issues.
Invalid request parameters.

Contribution Guidelines

Fork the repository.
Create a feature branch (git checkout -b feature/amazing-feature).
Commit your changes (git commit -m 'Add some amazing feature').
Push to the branch (git push origin feature/amazing-feature).
Open a Pull Request.

Usage with Cline

To use this MCP server with Cline, add the following configuration to your Cline MCP settings file (~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "trello-ts": {
      "command": "node",
      "args": ["/path/to/mcp-server-ts-trello/build/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key",
        "TRELLO_TOKEN": "your_token"
      }
    }
  }
}