trello-mcp server

trello-mcp

A self-hostable Model Context Protocol server that lets MCP-compatible clients work with Trello cards, lists, labels, attachments, checklists, members, and card activity.

The project is intentionally self-hostable and reusable. Contributions, adaptations, and focused issue reports are welcome.

The roadmap is, of course, tracked on Trello, and trello-mcp helps keep it up to date: trello-mcp roadmap.

Disclaimer

trello-mcp is an independent, community-maintained project. It is not an official Trello or Atlassian product, service, or MCP implementation, and it is not affiliated with, endorsed by, or sponsored by Trello or Atlassian.

This project exists to make it easier for MCP-compatible LLM clients to interface with Trello through Trello's public API and user-provided API credentials.

Looking for Trello's official hosted MCP server? Visit Trello MCP and use the endpoint documented by Trello: https://mcp.trello.com/v1.

Documentation

The complete project documentation is available at trello-mcp.com:

• Get started
• Create a Trello API key and token
• Set up your MCP client
• Browse the tool catalog
• Review API coverage and non-goals
• Understand Security & Data
• Operate a running deployment
• Troubleshoot an installation
• Official MCP Registry installation, releases, and recovery

Features

Board Discovery

• List boards visible to the authenticated Trello member.
• Read basic board metadata.
• List open, closed, or all lists on a board.
• List open, closed, visible, or all cards on a board.
• List board labels, members, and memberships.
• Create, inspect, update, and delete board labels.
• Create, inspect, rename, archive, unarchive, and move lists between boards.

Card Workflows

• Read cards by id, short id, or Trello card URL.
• Create cards with title, description, due date, position, members, and labels.
• Update card metadata including title, description, due date, due completion, and archived state.
• Move cards between lists or boards.
• Apply and remove existing labels on cards.
• Permanently delete cards only when explicitly requested.

Card Context

• List cards in a Trello list.
• List card attachments, inspect individual attachments, add public URL attachments, and upload server-local files from an explicitly configured directory.
• List, create, rename, and delete card checklists, and manage checklist items.
• List card members and add or remove members.
• Read card actions and activity history.
• Add, edit, and delete Trello card comments.

Search Workflows

• Search Trello cards, boards, members, and workspaces by natural language terms.
• Scope search results to specific boards, cards, or workspaces.
• Look up Trello members by name or username before assignment.
• Read member profiles, assigned cards, boards, and workspaces.

Workspace Discovery

• List Trello workspaces visible to the authenticated member.
• Read workspace metadata, boards, and members.

Self-Hosted Runtime

Shortened. The full README is on GitHub.