What is Mcp Server Ts Trello

mcp-server-ts-trello is a TypeScript implementation of a Model Context Protocol (MCP) server designed for integrating with Trello. It provides tools for AI assistants to interact with Trello boards, lists, and cards.

Use cases

Use cases include automating task management workflows, developing AI assistants that manage Trello boards, and integrating Trello with other applications for enhanced productivity.

How to use

To use mcp-server-ts-trello, first install the required dependencies using ‘make install’. Then, configure your Trello API credentials in a ‘.env’ file. You can start the server with ‘make start’ and use various MCP tools to interact with Trello.

Key features

Key features include full Trello API integration, asynchronous operations for improved performance, type-safe implementation using TypeScript, comprehensive error handling, and environment-based configuration.

Where to use

mcp-server-ts-trello can be used in project management, task automation, and AI assistant applications that require interaction with Trello boards and tasks.

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