Skip to main content
Glama

MCP Server Trello

MCP Server Trello

A Model Context Protocol (MCP) server that provides tools for interacting with Trello boards. This server enables seamless integration with Trello's API while handling rate limiting, type safety, and error handling automatically.

Changelog

0.3.0

  • Added board and workspace management capabilities:
    • list_boards - List all boards the user has access to
    • set_active_board - Set the active board for future operations
    • list_workspaces - List all workspaces the user has access to
    • set_active_workspace - Set the active workspace for future operations
    • list_boards_in_workspace - List all boards in a specific workspace
    • get_active_board_info - Get information about the currently active board
  • Added persistent configuration storage to remember active board/workspace
  • Improved error handling for all new operations

0.2.1

  • Added detailed JSDoc comments to rate limiter functions
  • Improved error handling for image attachment functionality
  • Updated documentation for attach_image_to_card tool

0.2.0

  • Added attach_image_to_card tool to attach images to cards from URLs
  • Added Docker support with multi-stage build
  • Improved security by moving environment variables to .env
  • Added Docker Compose configuration
  • Added .env.template for easier setup

0.1.1

  • Added move_card tool to move cards between lists
  • Improved documentation

0.1.0

  • Initial release with basic Trello board management features

Features

  • Full Trello Board Integration: Interact with cards, lists, and board activities
  • Built-in Rate Limiting: Respects Trello's API limits (300 requests/10s per API key, 100 requests/10s per token)
  • Type-Safe Implementation: Written in TypeScript with comprehensive type definitions
  • Input Validation: Robust validation for all API inputs
  • Error Handling: Graceful error handling with informative messages
  • Dynamic Board Selection: Switch between boards and workspaces without restarting

Installation

The easiest way to run the server is using Docker:

  1. Clone the repository:
git clone https://github.com/delorenj/mcp-server-trello cd mcp-server-trello
  1. Copy the environment template and fill in your Trello credentials:
cp .env.template .env
  1. Build and run with Docker Compose:
docker compose up --build

Installing via Smithery

To install Trello Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @modelcontextprotocol/mcp-server-trello --client claude

Manual Installation

npm install @delorenj/mcp-server-trello

Configuration

Environment Variables

The server can be configured using environment variables. Create a .env file in the root directory with the following variables:

# Required: Your Trello API credentials TRELLO_API_KEY=your-api-key TRELLO_TOKEN=your-token # Required: Initial board ID (can be changed later using set_active_board) TRELLO_BOARD_ID=your-board-id # Optional: Initial workspace ID (can be changed later using set_active_workspace) TRELLO_WORKSPACE_ID=your-workspace-id

You can get these values from:

Board and Workspace Management

Starting with version 0.3.0, the MCP server supports dynamic board and workspace selection:

  • The TRELLO_BOARD_ID in your .env file is used as the initial board ID when the server starts
  • You can change the active board at any time using the set_active_board tool
  • The selected board persists between server restarts (stored in ~/.trello-mcp/config.json)
  • Similarly, you can set and persist an active workspace using set_active_workspace

This allows you to work with multiple boards and workspaces without restarting the server or changing environment variables.

Example Workflow
  1. Start by listing available boards:
{ name: 'list_boards', arguments: {} }
  1. Set your active board:
{ name: 'set_active_board', arguments: { boardId: "abc123" // ID from list_boards response } }
  1. List workspaces if needed:
{ name: 'list_workspaces', arguments: {} }
  1. Set active workspace if needed:
{ name: 'set_active_workspace', arguments: { workspaceId: "xyz789" // ID from list_workspaces response } }
  1. Check current active board info:
{ name: 'get_active_board_info', arguments: {} }

Available Tools

get_cards_by_list_id

Fetch all cards from a specific list.

{ name: 'get_cards_by_list_id', arguments: { listId: string // ID of the Trello list } }

get_lists

Retrieve all lists from the currently active board.

{ name: 'get_lists', arguments: {} }

get_recent_activity

Fetch recent activity on the currently active board.

{ name: 'get_recent_activity', arguments: { limit?: number // Optional: Number of activities to fetch (default: 10) } }

add_card_to_list

Add a new card to a specified list.

{ name: 'add_card_to_list', arguments: { listId: string, // ID of the list to add the card to name: string, // Name of the card description?: string, // Optional: Description of the card dueDate?: string, // Optional: Due date (ISO 8601 format) labels?: string[] // Optional: Array of label IDs } }

update_card_details

Update an existing card's details.

{ name: 'update_card_details', arguments: { cardId: string, // ID of the card to update name?: string, // Optional: New name for the card description?: string, // Optional: New description dueDate?: string, // Optional: New due date (ISO 8601 format) labels?: string[] // Optional: New array of label IDs } }

archive_card

Send a card to the archive.

{ name: 'archive_card', arguments: { cardId: string // ID of the card to archive } }

add_list_to_board

Add a new list to the currently active board.

{ name: 'add_list_to_board', arguments: { name: string // Name of the new list } }

archive_list

Send a list to the archive.

{ name: 'archive_list', arguments: { listId: string // ID of the list to archive } }

get_my_cards

Fetch all cards assigned to the current user.

{ name: 'get_my_cards', arguments: {} }

move_card

Move a card to a different list.

{ name: 'move_card', arguments: { cardId: string, // ID of the card to move listId: string // ID of the target list } }

attach_image_to_card

Attach an image to a card directly from a URL.

{ name: 'attach_image_to_card', arguments: { cardId: string, // ID of the card to attach the image to imageUrl: string, // URL of the image to attach name?: string // Optional: Name for the attachment (defaults to "Image Attachment") } }

list_boards

List all boards the user has access to.

{ name: 'list_boards', arguments: {} }

set_active_board

Set the active board for future operations.

{ name: 'set_active_board', arguments: { boardId: string // ID of the board to set as active } }

list_workspaces

List all workspaces the user has access to.

{ name: 'list_workspaces', arguments: {} }

set_active_workspace

Set the active workspace for future operations.

{ name: 'set_active_workspace', arguments: { workspaceId: string // ID of the workspace to set as active } }

list_boards_in_workspace

List all boards in a specific workspace.

{ name: 'list_boards_in_workspace', arguments: { workspaceId: string // ID of the workspace to list boards from } }

get_active_board_info

Get information about the currently active board.

{ name: 'get_active_board_info', arguments: {} }

Rate Limiting

The server implements a token bucket algorithm for rate limiting to comply with Trello's API limits:

  • 300 requests per 10 seconds per API key
  • 100 requests per 10 seconds per token

Rate limiting is handled automatically, and requests will be queued if limits are reached.

Error Handling

The server provides detailed error messages for various scenarios:

  • Invalid input parameters
  • Rate limit exceeded
  • API authentication errors
  • Network issues
  • Invalid board/list/card IDs

Development

Prerequisites

  • Node.js 16 or higher
  • npm or yarn

Setup

  1. Clone the repository
git clone https://github.com/delorenj/mcp-server-trello cd mcp-server-trello
  1. Install dependencies
npm install
  1. Build the project
npm run build

Contributing

Contributions are welcome!

License

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

Acknowledgments

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Facilitates interaction with Trello boards via the Trello API, offering features like rate limiting, type safety, input validation, and error handling for seamless management of cards, lists, and board activities.

  1. Changelog
    1. 0.3.0
    2. 0.2.1
    3. 0.2.0
    4. 0.1.1
    5. 0.1.0
  2. Features
    1. Installation
      1. Docker Installation (Recommended)
      2. Installing via Smithery
      3. Manual Installation
    2. Configuration
      1. Environment Variables
      2. Board and Workspace Management
    3. Available Tools
      1. get_cards_by_list_id
      2. get_lists
      3. get_recent_activity
      4. add_card_to_list
      5. update_card_details
      6. archive_card
      7. add_list_to_board
      8. archive_list
      9. get_my_cards
      10. move_card
      11. attach_image_to_card
      12. list_boards
      13. set_active_board
      14. list_workspaces
      15. set_active_workspace
      16. list_boards_in_workspace
      17. get_active_board_info
    4. Rate Limiting
      1. Error Handling
        1. Development
          1. Prerequisites
          2. Setup
        2. Contributing
          1. License
            1. Acknowledgments

              Related MCP Servers

              • A
                security
                F
                license
                A
                quality
                Enables interaction with Trello boards, lists, and cards through Model Context Protocol (MCP) tools, leveraging TypeScript for type safety and asynchronous operations.
                Last updated -
                5
                JavaScript
              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that provides tools for interacting with Trello boards, enabling seamless management of cards, lists, and activities while handling rate limiting and type safety.
                Last updated -
                10
                3
                JavaScript
                MIT License
                • Apple
              • -
                security
                A
                license
                -
                quality
                Connects to Trello with all the tools available that I was able to find in API reference
                Last updated -
                3
                1
                TypeScript
                MIT License
              • A
                security
                A
                license
                A
                quality
                Enables seamless integration with Trello boards, allowing users to manage cards, lists, and activities while automatically handling rate limiting and providing type safety.
                Last updated -
                9
                TypeScript
                MIT License

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/delorenj/mcp-server-trello'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server