Metadata-Version: 2.4
Name: trello-gantt-mcp
Version: 0.1.0
Summary: MCP server for generating Gantt charts from Trello boards.
Author: DSpot Automation
License-Expression: MIT
Project-URL: Homepage, https://github.com/DSpot-Automation/gantt-chart-generation
Project-URL: Repository, https://github.com/DSpot-Automation/gantt-chart-generation
Keywords: trello,gantt,mermaid,mcp,claude
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Scheduling
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: trello-gantt>=0.1.2
Requires-Dist: mcp>=1.0

# trello-gantt-mcp

MCP server that generates Mermaid Gantt chart HTML files from Trello boards. Built on top of the [`trello-gantt`](https://pypi.org/project/trello-gantt/) CLI package.

## Installation

```bash
pip install trello-gantt-mcp
```

## Configuration

Add the server to your Claude Desktop or Claude Code configuration:

### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "trello-gantt": {
      "command": "trello-gantt-mcp",
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_API_TOKEN": "your-api-token"
      }
    }
  }
}
```

### Claude Code

Edit `.claude/settings.json`:

```json
{
  "mcpServers": {
    "trello-gantt": {
      "command": "trello-gantt-mcp",
      "env": {
        "TRELLO_API_KEY": "your-api-key",
        "TRELLO_API_TOKEN": "your-api-token"
      }
    }
  }
}
```

## Getting Trello credentials

1. Get your API key at https://trello.com/power-ups/admin
2. Generate a token from the same page (click the "Token" link next to your key)

## Tool: generate_gantt

Generates a standalone HTML file with an interactive Mermaid Gantt chart.

### Parameters

| Parameter | Required | Default | Description |
|-----------|----------|---------|-------------|
| `board_id` | Yes | - | Trello board ID or full URL |
| `lists` | No | all open lists | Comma-separated list names to include |
| `title` | No | "Project Gantt Chart" | Chart title in the HTML output |
| `milestone_list` | No | - | Comma-separated list names to render as milestones |
| `output` | No | "gantt.html" | Output HTML file path |

### Example usage

> Generate a Gantt chart for https://trello.com/b/abc123/my-project

The tool returns the absolute path to the generated HTML file along with a summary of cards processed.

## License

MIT
