Trello MCP Server (TypeScript)

View original on GitHub

A TypeScript implementation of a Model Context Protocol (MCP) server for Trello integration, providing tools for AI assistants to interact with Trello boards, lists, and cards.

Features

Full Trello API integration through MCP tools
Asynchronous operations for better performance
Type-safe implementation using TypeScript
Comprehensive error handling
Environment-based configuration

Prerequisites

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

Installation


# Install dependencies
make install

Configuration

Create a .env file in the root directory with 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 linter
make lint

MCP Tools

get_boards

Retrieves all Trello boards for the authenticated user.


// No input parameters required

get_lists

Fetches all lists from a specified board.


{
  "request": {
    "board_id": string // ID of the board
  }
}

get_cards

Gets cards from a board or specific list.


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

get_card_details

Retrieves detailed information about a specific card.


{
  "request": {
    "card_id": string      // ID of the card
  }
}

Development

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

src/index.ts - Main server entry point
src/trello-client.ts - Trello API client implementation
src/types.ts - TypeScript type definitions

Building

The project uses TypeScript compiler for building:


# Build the project
make build
 
# The output will be in the build/ directory

Error Handling

The server implements comprehensive error handling for:

API authentication errors
Rate limiting
Network issues
Invalid request parameters

Contributing

Fork the repository
Create your 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

Using 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"
      }
    }
  }
}

After adding the configuration and restarting Cline, you can use the following MCP tools:

get_boards: List all Trello boards
get_lists: Get lists from a board
get_cards: Get cards from a board or list
get_card_details: Get detailed card information

License

ISC License - See LICENSE file for details