trello-mcp-server by Adoliin - MCP Server

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

Clone this repository:

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

Install dependencies:
```
npm install
```
Create a .env file based on .env.example:
```
cp .env.example .env
```
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

Build the project:
```
npm run build
```
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

Optional environment variables:

TRELLO_ALLOWED_BOARD_IDS - Comma-separated list of board IDs to restrict access to

Board Access Control

You can restrict the MCP server to only access specific Trello boards by setting the TRELLO_ALLOWED_BOARD_IDS environment variable. This is useful for limiting the scope of the server to only work with certain boards.

To use this feature:

Identify the board IDs you want to allow access to
Set the TRELLO_ALLOWED_BOARD_IDS environment variable to a comma-separated list of these IDs:
```
TRELLO_ALLOWED_BOARD_IDS=board123,board456,board789
```

Alternatively, use the command line argument:

npm start -- --env TRELLO_ALLOWED_BOARD_IDS=board123,board456,board789

When this feature is enabled:

The server will deny operations on boards not in the allowed list
Access attempts to unauthorized boards will return an error message
Cards and lists are checked based on the board they belong to
Debugging can be enabled by setting DEBUG=true to see detailed logs of unauthorized access attempts

If no board IDs are specified, the server will allow access to all boards.

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
Board access control logging

License

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