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

Related MCP server: Claude MCP Trello

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: