Trello MCP Server
Manage Trello boards, lists, and cards from any MCP-compatible AI assistant
Open source Open in the app JSON README (API)
About
Manage Trello boards, lists, and cards from any MCP-compatible AI assistant
Details
- Kind
- MCP servers
- Topic
- Productivity
- Publisher
- jimdrews
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.5.0
- Stars
- 2
- Forks
- 2
- Last push
- 2026-04-06T02:31:00Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:01:59
- Updated
- 2026-08-29 03:01:59
- Origin id
io.github.Jimdrews/fastmcp-trello
README
<p align="center">
<img src="banner.svg" alt="fastmcp-trello" width="100%">
</p>
[](https://pypi.org/project/fastmcp-trello/)
[](https://pypi.org/project/fastmcp-trello/)
[](https://github.com/Jimdrews/fastmcp-trello/actions/workflows/ci.yml)
[](https://opensource.org/licenses/MIT)
A Trello MCP server — manage boards, cards, and lists from any AI assistant that supports the [Model Context Protocol](https://modelcontextprotocol.io). MCP is an open standard that lets AI assistants like Claude, Cursor, and Copilot interact with external tools and services.
## Trello MCP Tools
| Tool | Description |
|---|---|
| `get_boards` | List all boards accessible to you |
| `get_board` | Get a board's details including its lists |
| `get_lists` | Get all open lists on a board |
| `create_board` | Create a new board |
| `update_board` | Update a board's name or description |
| `close_board` | Close (archive) a board |
| `get_cards` | Get all cards in a list |
| `get_card` | Get full details for a card including comments |
| `create_card` | Create a new card on a list |
| `update_card` | Update a card's fields or move it to a different list |
| `archive_card` | Archive (close) a card |
| `get_labels` | Get all labels defined on a board |
| `create_label` | Create a new label on a board |
| `delete_label` | Delete a label from a board |
| `add_label_to_card` | Add a label to a card |
| `remove_label_from_card` | Remove a label from a card |
| `create_list` | Create a new list on a board |
| `update_list` | Rename a list |
| `archive_list` | Archive (close) a list |
| `move_list` | Move a list to a new position |
| `get_attachments` | Get all attachments on a card |
| `add_attachment` | Add a URL attachment to a card |
| `delete_attachment` | Delete an attachment from a card |
| `add_comment` | Add a comment to a card |
| `search_cards` | Search for cards across boards, optionally scoped to a specific board |
## Prerequisites
You need a Trello API key and token:
1. Go to the [Trello Power-Ups admin page](https://trello.com/power-ups/admin)
2. Create a new Power-Up (any name/workspace will do)
3. Generate a new API key
4. From the API key page, click the **Token** link to generate a token
## Installation
Add the following to your MCP client configuration (Claude Desktop, Cursor, Windsurf, etc.):
```json
{
"mcpServers": {
"trello": {
"command": "uvx",
"args": ["fastmcp-trello"],
"env": {
"TRELLO_API_KEY": "your-api-key",
"TRELLO_TOKEN": "your-token"
}
}
}
}
```
Or run standalone:
```bash
TRELLO_API_KEY=your-api-key TRELLO_TOKEN=your-token uvx fastmcp-trello
```
## Usage
Once installed in your MCP client, you can ask your AI assistant things like:
> "Show me all my Trello boards"
> "Create a card called 'Fix login bug' in the To Do list on my Project board"
## Configuration
| Variable | Required | Description |
|---|---|---|
| `TRELLO_API_KEY` | Yes | Your Trello API key |
| `TRELLO_TOKEN` | Yes | Your Trello authentication token |
## Development
```bash
git clone https://github.com/Jimdrews/fastmcp-trello.git
cd fastmcp-trello
uv sync --group dev
uv run pytest
```
See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
## License
[MIT](LICENSE)
<!-- mcp-name: io.github.Jimdrews/fastmcp-trello -->