Trello

Interact with Trello boards, lists, and cards using the Trello API.

View on GitHub →

Trello MCP Server (TypeScript)

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

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. 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

Related Servers