Trello Task Manager MCP

LLM Task management System that integrates as an MCP Server and uses Trello for managing tasks/cards.

See Demo Video

Features

• Create and manage tasks in Trello boards

• Update task descriptions

• Mark tasks as in-progress or completed

• Get next available task

• Get filtered list of tasks (all, work-in-progress, or completed)

• Add and manage checklists for tasks

• Get next unchecked checklist item for focused work

• Interactive feedback UI for collecting user feedback on project changes

Prerequisites

• Python 3.10 or higher

• uv

• A Trello account with API Key and Token

Installation

1. Clone the repository:

   git clone https://github.com/namuan/trello-task-manager-mcp.git
   cd trello-task-manager-mcp

2. Install dependencies:

   uv sync

3. Create a .env file in the project root with your Trello credentials:

   TRELLO_API_KEY=your_api_key
   TRELLO_API_TOKEN=your_api_token
   TRELLO_BOARD_NAME=your_board_name
   HOST=127.0.0.1  # Optional, defaults to 127.0.0.1
   PORT=8050      # Optional, defaults to 8050

4. Run the application

   trello-task-manager-mcp

   or

   make run

MCP Integration

Add the following entry to your MCP client:

{
  "mcpServers": {
    "trello-task-manager": {
      "type": "sse",
      "url": "http://localhost:8050/sse",
      "note": "For SSE connections, add this URL directly in your MCP Client"
    }
  }
}

Usage

Ask MCP Client to use Trello task manager along with the instructions to use one of these tools.

• add_task: Create a new task

• update_task_description: Update a task's description

• get_next_available_task: Get the next available task

• get_tasks: Get a list of tasks with optional filtering (all, wip, done)

• mark_as_in_progress: Mark a task as in progress

• mark_as_completed: Mark a task as completed

• update_task_with_checklist: Add or update a checklist for a task

• complete_checklist_item: Mark a specific checklist item as completed

• get_next_unchecked_checklist_item: Get the next unchecked checklist item for a task

• interactive_feedback: Launch an interactive GUI for collecting user feedback on project changes

Development

Setup Development Environment

This project uses uv for dependency management. Run the following command to set up your development environment:

make install

This will:

• Create a virtual environment using uv

• Install project dependencies

• Set up pre-commit hooks

Development Commands

The project includes several helpful make commands:

make help     # Show all available commands with descriptions
make check    # Run code quality tools (lock file check and pre-commit)
make run      # Run the application
make build    # Build wheel file

License

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