Trello MCP Server

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

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Enables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Drupal-Modules-MCP MCP Server
Cleversoft-IT
A
security
A
license
A
quality
This TypeScript-based MCP server allows users to manage and interact with a note system through Model Context Protocol, enabling note creation and summarization with URIs and metadata.
Last updated -
1
JavaScript
MIT License
Claude MCP Trello
hrs-asano
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for interacting with Trello boards, enabling seamless management of cards, lists, and activities while handling rate limiting and type safety.
Last updated -
10
8
JavaScript
MIT License
MCP Server Trello
diegofornalha
A
security
A
license
A
quality
Enables seamless integration with Trello boards, allowing users to manage cards, lists, and activities while automatically handling rate limiting and providing type safety.
Last updated -
9
TypeScript
MIT License
Trello MCP Server with Python
m0xai
-
security
F
license
-
quality
A powerful MCP server for interacting with Trello boards, lists, and cards via AI Hosts.
Last updated -
26
Python

View all related MCP servers

Trello MCP Server