Labsco
kocakli logo

Trello MCP

★ 31

from kocakli

Trello Desktop MCP server that enables Claude Desktop to interact with Trello boards, cards, lists, and team members through natural language commands.

🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup
#automation#git#security#project-mgmt

Trello MCP

A Model Context Protocol (MCP) server that provides comprehensive Trello integration for any MCP-compatible client — including Claude Desktop, Claude Code, Gemini CLI, and more. This server enables AI assistants to interact with Trello boards, cards, lists, and more through a secure local connection.

Features

🔍 Search & Discovery

  • Universal Search: Search across all Trello content (boards, cards, members, organizations)
  • User Boards: Get all boards accessible to the current user
  • Board Details: Retrieve detailed information about boards including lists and cards

📝 Card Management

  • Create Cards: Add new cards to any list with descriptions, due dates, and assignments
  • Update Cards: Modify card properties like name, description, due dates, and status
  • Move Cards: Transfer cards between lists to update workflow status
  • Get Card Details: Fetch comprehensive card information including members, labels, and checklists

💬 Collaboration

  • Add Comments: Post comments on cards for team communication
  • Member Management: View board members and member details
  • Activity History: Track card actions and changes

📋 Organization

  • List Management: Create new lists and get cards within specific lists
  • Labels: View and manage board labels for categorization
  • Checklists: Access card checklists and checklist items
  • Attachments: View card attachments and linked files

Available Tools

The MCP server provides 19 tools organized into three phases:

Phase 1: Essential Tools

  • trello_search - Universal search across all Trello content
  • trello_get_user_boards - Get all boards accessible to the current user
  • get_board_details - Get detailed board information with lists and cards
  • get_card - Get comprehensive card details
  • create_card - Create new cards in any list

Phase 2: Core Operations

  • update_card - Update card properties
  • move_card - Move cards between lists
  • trello_add_comment - Add comments to cards
  • trello_get_list_cards - Get all cards in a specific list
  • trello_create_list - Create new lists on boards

Phase 3: Advanced Features

  • trello_get_board_cards - Get all cards from a board with filtering
  • trello_get_card_actions - Get card activity history
  • trello_get_card_attachments - Get card attachments
  • trello_get_card_checklists - Get card checklists
  • trello_get_board_members - Get board members
  • trello_get_board_labels - Get board labels
  • trello_get_member - Get member details

Legacy Tools (Backward Compatibility)

  • list_boards - List user's boards
  • get_lists - Get lists in a board

Architecture

MCP Protocol

The server implements the Model Context Protocol (MCP), which provides:

  • Standardized tool discovery and invocation
  • Type-safe parameter validation
  • Structured error handling
  • Automatic credential management

Security

  • API credentials are stored locally in your MCP client's config
  • No credentials are transmitted over the network
  • All Trello API calls use HTTPS
  • Rate limiting is respected with automatic retry logic

Technical Stack

  • TypeScript for type safety
  • MCP SDK for protocol implementation
  • Zod for schema validation
  • Fetch API for HTTP requests

Development

Project Structure

├── src/
│   ├── index.ts          # Main MCP server entry point
│   ├── server.ts         # Alternative server implementation
│   ├── tools/            # Tool implementations
│   │   ├── boards.ts     # Board-related tools
│   │   ├── cards.ts      # Card-related tools
│   │   ├── lists.ts      # List-related tools
│   │   ├── members.ts    # Member-related tools
│   │   ├── search.ts     # Search functionality
│   │   └── advanced.ts   # Advanced features
│   ├── trello/           # Trello API client
│   │   └── client.ts     # API client with retry logic
│   ├── types/            # TypeScript type definitions
│   └── utils/            # Utility functions
├── dist/                 # Compiled JavaScript
└── package.json          # Project configuration

Building from Source

# Install dependencies
npm install

# Build the project
npm run build

# Run type checking
npm run type-check

Testing

The server includes comprehensive error handling and validation. Test your setup by:

  1. Checking your MCP client's connection status
  2. Running a simple command like "Show me my Trello boards"
  3. Verifying the response includes your board data