mcp-server-ts-trello

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