What is Trello Mcp Server

The trello-mcp-server is a Model Context Protocol (MCP) server designed to facilitate interactions with the Trello API, enabling users to manage Trello boards, lists, cards, and more through a structured and modular approach.

Use cases

Use cases for trello-mcp-server include automating Trello board management, building custom applications that leverage Trello’s features, creating integrations with other tools, and enhancing team collaboration through customized workflows.

How to use

To use trello-mcp-server, clone the repository, install the dependencies, configure your Trello API key and token in a .env file, build the project, and start the server. Detailed steps are provided in the README.

Key features

Key features include complete Trello integration, comprehensive API coverage for major operations, a modular architecture for clear separation of concerns, full TypeScript support for type safety, and robust error handling throughout the codebase.

Where to use

trello-mcp-server can be used in software development projects that require integration with Trello for task management, project tracking, and collaboration tools, particularly in agile environments.

Trello MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Trello API. Built on the Generic MCP Server Template.

Features

• Trello Integration: Complete access to Trello boards, lists, cards, and more
• Comprehensive API Coverage: Support for all major Trello operations
• Modular Architecture: Clear separation of concerns with a well-defined structure
• Type Safety: Full TypeScript support with proper typing for Trello objects
• Error Handling: Robust error management throughout the codebase

Project Structure

trello-mcp-server/
├── src/
│   ├── services/       # Service classes for Trello API interactions
│   │   ├── base-service.ts        # Abstract base service with common functionality
│   │   ├── trello-service.ts      # Core Trello API service
│   │   ├── board-service.ts       # Service for Trello boards
│   │   ├── list-service.ts        # Service for Trello lists
│   │   ├── card-service.ts        # Service for Trello cards
│   │   ├── member-service.ts      # Service for Trello members
│   │   ├── label-service.ts       # Service for Trello labels
│   │   ├── checklist-service.ts   # Service for Trello checklists
│   │   └── service-factory.ts     # Factory for creating service instances
│   ├── tools/          # MCP tool definitions and handlers
│   │   ├── board-tools.ts         # Board tool definitions
│   │   ├── board-tool-handlers.ts # Board tool handlers
│   │   ├── list-tools.ts          # List tool definitions
│   │   ├── list-tool-handlers.ts  # List tool handlers
│   │   ├── card-tools.ts          # Card tool definitions
│   │   ├── card-tool-handlers.ts  # Card tool handlers
│   │   ├── member-tools.ts        # Member tool definitions
│   │   ├── member-tool-handlers.ts # Member tool handlers
│   │   ├── label-tools.ts         # Label tool definitions
│   │   ├── label-tool-handlers.ts # Label tool handlers
│   │   ├── checklist-tools.ts     # Checklist tool definitions
│   │   ├── checklist-tool-handlers.ts # Checklist tool handlers
│   │   ├── trello-tools.ts        # Combined tool definitions
│   │   └── trello-tool-handlers.ts # Combined tool handlers
│   ├── types/          # TypeScript type definitions
│   │   └── trello-types.ts        # Trello type definitions
│   ├── config.ts       # Configuration management
│   └── index.ts        # Main entry point
├── .env.example        # Example environment variables
├── package.json        # Project dependencies and scripts
├── tsconfig.json       # TypeScript configuration
└── README.md           # Project documentation

Getting Started

Prerequisites

• Node.js 18 or higher
• npm or yarn
• Trello API key and token

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/trello-mcp-server.git
   cd trello-mcp-server
   

2. Install dependencies:

   npm install
   

3. Create a .env file based on .env.example:

   cp .env.example .env
   

4. Edit the .env file with your Trello API key and token:

   TRELLO_API_KEY=your_trello_api_key
   TRELLO_TOKEN=your_trello_token
   

   You can obtain these from the Trello Developer Portal.

Building and Running

1. Build the project:

   npm run build
   

2. Run the server:

   npm start
   

Available Tools

The server provides tools for interacting with all major Trello resources:

Board Tools

• get_boards - Get all boards for the authenticated user
• get_board - Get a specific board by ID
• create_board - Create a new board
• update_board - Update an existing board
• delete_board - Delete a board
• get_board_lists - Get all lists on a board
• get_board_members - Get all members of a board
• get_board_labels - Get all labels on a board
• close_board - Close (archive) a board
• reopen_board - Reopen a closed board

List Tools

• get_list - Get a specific list by ID
• create_list - Create a new list on a board
• update_list - Update an existing list
• archive_list - Archive a list
• unarchive_list - Unarchive a list
• move_list_to_board - Move a list to a different board
• get_cards_in_list - Get all cards in a list
• archive_all_cards - Archive all cards in a list
• move_all_cards - Move all cards in a list to another list
• update_list_position - Update the position of a list on a board
• update_list_name - Update the name of a list
• subscribe_to_list - Subscribe to a list

Card Tools

• get_card - Get a specific card by ID
• create_card - Create a new card
• update_card - Update an existing card
• delete_card - Delete a card
• archive_card - Archive a card
• unarchive_card - Unarchive a card
• move_card_to_list - Move a card to a different list
• add_comment - Add a comment to a card
• get_comments - Get comments on a card
• add_attachment - Add an attachment to a card
• get_attachments - Get attachments on a card
• delete_attachment - Delete an attachment from a card
• add_member - Add a member to a card
• remove_member - Remove a member from a card
• add_label - Add a label to a card
• remove_label - Remove a label from a card
• set_due_date - Set the due date for a card
• set_due_complete - Mark a card’s due date as complete or incomplete

Member Tools

• get_me - Get the authenticated member (current user)
• get_member - Get a specific member by ID or username
• get_member_boards - Get boards that a member belongs to
• get_member_cards - Get cards assigned to a member
• get_boards_invited - Get boards that a member has been invited to
• get_member_organizations - Get organizations that a member belongs to
• get_notifications - Get notifications for the authenticated member
• update_me - Update the authenticated member’s information
• get_avatar - Get the authenticated member’s avatar
• search_members - Search for members by name
• get_board_members - Get members of a board
• get_organization_members - Get members of an organization
• get_card_members - Get members assigned to a card

Label Tools

• get_label - Get a specific label by ID
• create_label - Create a new label on a board
• update_label - Update an existing label
• delete_label - Delete a label
• get_board_labels - Get all labels on a board
• update_label_name - Update the name of a label
• update_label_color - Update the color of a label
• create_label_on_card - Create a new label directly on a card
• get_card_labels - Get all labels on a card
• add_label_to_card - Add a label to a card
• remove_label_from_card - Remove a label from a card

Checklist Tools

• get_checklist - Get a specific checklist by ID
• create_checklist - Create a new checklist on a card
• update_checklist - Update an existing checklist
• delete_checklist - Delete a checklist
• get_checkitems - Get all checkitems on a checklist
• create_checkitem - Create a new checkitem on a checklist
• get_checkitem - Get a specific checkitem on a checklist
• update_checkitem - Update a checkitem on a checklist
• delete_checkitem - Delete a checkitem from a checklist
• update_checklist_name - Update the name of a checklist
• update_checklist_position - Update the position of a checklist on a card
• get_checklist_board - Get the board a checklist is on
• get_checklist_card - Get the card a checklist is on
• update_checkitem_state_on_card - Update a checkitem’s state on a card

Configuration

The server uses a centralized configuration system in src/config.ts. Configuration can be provided through:

• Environment variables
• Command line arguments (with --env KEY=VALUE)
• Default values in the code

Required environment variables:

• TRELLO_API_KEY - Your Trello API key
• TRELLO_TOKEN - Your Trello API token

Error Handling

The server includes comprehensive error handling:

• Service-level error handling with rate limiting support
• Tool-level error handling with proper error messages
• MCP protocol error handling
• Trello API error handling

License

This project is licensed under the MIT License - see the LICENSE file for details.