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

Related MCP server: MCP Server Trello

Project Structure

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.