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

1. Clone this repository:

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

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. 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