Trello MCP Server by v4lheru - MCP Server

Trello MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Trello API.

Credentials are stored securely in your OS credential manager, not in plaintext files.

Features

Secure Credential Storage: Credentials stored in OS credential manager (Windows Credential Manager, macOS Keychain, or Linux libsecret)
No Plaintext Secrets: No .env files, no environment variables for credentials
Trello Integration: Complete access to Trello boards, lists, cards, and more
Comprehensive API Coverage: Support for all major Trello operations
Type Safety: Full TypeScript support with proper typing for Trello objects
Error Handling: Robust error management throughout the codebase

Getting Started

Prerequisites

Node.js 18 or higher
npm
Trello API key and token (see below)

Linux only: Install libsecret

# Debian/Ubuntu
sudo apt install libsecret-1-dev

# Fedora
sudo dnf install libsecret-devel

# Arch
sudo pacman -S libsecret

Installation

Clone this repository:

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

Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Set up your credentials securely:
```
npm run setup-credentials
```
This will prompt you for your Trello API key and token, then store them in your OS credential manager.

To get your credentials:
1. Go to https://trello.com/app-key
2. Copy your API Key
3. Click "Generate a Token" and copy the token

Usage

Start the MCP server:

npm start

Migrating from .env Files

If you have existing credentials in a .env file, the setup script will automatically detect them:

npm run setup-credentials

You'll see:

📁 Found existing credentials in: /path/to/.env
   Both API Key and Token found.

Migrate these credentials to secure storage? (Y/n):

After migration, you can optionally remove the credentials from your .env file.

Managing Credentials

Set/update credentials: npm run setup-credentials
Delete credentials: npm run delete-credentials

Credentials are stored in:

Windows: Credential Manager → Windows Credentials → trello-mcp-server
macOS: Keychain Access → trello-mcp-server
Linux: GNOME Keyring / KDE Wallet → trello-mcp-server

Claude Desktop Configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["C:/path/to/trello-mcp-server/build/index.js"]
    }
  }
}

Available Tools

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

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
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
set_due_date - Set the due date for a card
set_due_complete - Mark a card's due date as complete

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
search_members - Search for members by name

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
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
update_checkitem - Update a checkitem on a checklist
delete_checkitem - Delete a checkitem from a checklist

Security

Credentials are stored in your OS credential manager (Windows Credential Manager, macOS Keychain, or Linux libsecret) and encrypted using your login credentials.

License

This project is licensed under the MIT License.

v4lheru/trello-mcp-server