# agrath/Trello-Desktop-MCP [Health: Active]

**Category:** 📋 Product Management  
**Repository:** https://github.com/agrath/Trello-Desktop-MCP  
**GitHub Stars:** 3  
**npm Downloads (last month):** 300  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/agrath-trello-desktop-mcp

## Description
Comprehensive Trello integration: 46 tools covering boards, cards, lists, labels, checklists, attachments, members, custom fields, and search. Read-only mode, image attachment

## Tools
Capabilities this server exposes over MCP:

- **trello_search** — Universal search across all Trello content (boards, cards, members). Use this to find specific items by keywords or phrases.
- **trello_get_user_boards** — Get all boards accessible to the current user. This is the starting point for exploring your Trello workspace.
- **get_board_details** — Get information about a Trello board. IMPORTANT: Start with includeDetails=false (default) to get board metadata and lists only. Then use get_card or trello_get_list_cards to drill into specific cards. Only set includeDetails=true for small boards when you need a full overview.
- **get_card** — Get detailed information about a specific Trello card, including its content, status, members, and attachments.
- **create_card** — Create a new card in a Trello list. Use this to add tasks, ideas, or items to your workflow.
- **update_card** — Update properties of an existing Trello card. Use this to change card details like name, description, due date, or status.
- **move_card** — Move a card to a different list. Use this to change a card's workflow status (e.g., from "To Do" to "In Progress").
- **trello_add_comment** — Add a comment to a Trello card. Use this to add notes, updates, or discussions to cards.
- **trello_get_list_cards** — Get all cards in a specific Trello list. Use this to see all tasks/items in a workflow column.
- **trello_create_list** — Create a new list in a Trello board. Use this to add workflow columns like "To Do", "In Progress", or "Done".
- **list_boards** — List all Trello boards accessible to the user. Use this to see all boards you have access to, or filter by status.
- **get_lists** — Get all lists in a specific Trello board. Use this to see the workflow columns (like "To Do", "In Progress", "Done") in a board.
- **trello_get_member** — Get details about a specific Trello member/user, including their boards and profile information.
- **trello_get_board_cards** — Get cards from a Trello board with optional filtering (by status or by assigned member) and detailed information like attachments and members.
- **trello_get_card_actions** — Get activity history and comments for a specific Trello card. Useful for tracking changes and discussions.
- **trello_get_card_attachments** — Get all attachments (files, links) for a specific Trello card.
- **trello_create_card_attachment** — Attach a URL or local file to a Trello card. Provide either a url (for link attachments) or filePath (for file uploads from the local filesystem).
- **trello_get_card_attachment** — Get details of a single attachment on a Trello card by its attachment ID.
- **trello_delete_card_attachment** — Delete an attachment from a Trello card.
- **trello_get_card_checklists** — Get all checklists and their items for a specific Trello card.
- **trello_get_board_members** — Get all members who have access to a specific Trello board.
- **trello_get_board_labels** — Get all labels available on a specific Trello board for categorizing cards.
- **trello_create_label** — Create a new label on a Trello board.
- **trello_update_label** — Update the name or color of an existing Trello label.
- **trello_add_label_to_card** — Assign an existing label to a Trello card.
- **trello_remove_label_from_card** — Remove a label from a Trello card.
- **trello_delete_label** — Delete a label from a Trello board.
- **trello_add_member_to_card** — Add a member to a Trello card.
- **trello_remove_member_from_card** — Remove a member from a Trello card.
- **trello_get_board_custom_fields** — Get all custom field definitions for a Trello board. Returns field names, types, and options.
- **trello_archive_card** — Archive or unarchive a Trello card. Set value to true to archive, false to unarchive.
- **trello_filter_lists** — Filter lists on a board by name. Returns lists whose name contains the filter string (case-insensitive).
- **trello_create_checklist** — Create a checklist on a card. Optionally copy items from an existing checklist.
- **trello_get_checklist** — Get a single checklist with its check items.
- **trello_update_checklist** — Update a checklist name or position.
- **trello_delete_checklist** — Delete a checklist from a card.
- **trello_get_checklist_field** — Get a specific field (name or pos) from a checklist.
- **trello_update_checklist_field** — Update a specific field (name or pos) on a checklist.
- **trello_get_board_for_checklist** — Get the board that a checklist belongs to.
- **trello_get_card_for_checklist** — Get the card that a checklist belongs to.
- **trello_get_check_items** — Get all items on a checklist. Supports filtering by state (all, complete, incomplete).
- **trello_create_check_item** — Add an item to a checklist. Supports due dates and member assignment.
- **trello_get_check_item** — Get a single check item from a checklist.
- **trello_delete_check_item** — Delete an item from a checklist.
- **trello_update_check_item** — Update a check item on a card (name, state, position, due date, member). Use state to check/uncheck items.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "trello-desktop-mcp": {
    "command": "npx",
    "args": ["-y","atlassian-trello-mcp"],
    "env": {
      "TRELLO_API_KEY": "",
      "TRELLO_TOKEN": "",
      "TRELLO_READ_ONLY": ""
    }
  }
}
```

**Requires environment variables:** `TRELLO_API_KEY`, `TRELLO_TOKEN`, `TRELLO_READ_ONLY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What agrath/Trello-Desktop-MCP MCP server does

The agrath/Trello-Desktop-MCP MCP server gives an MCP client access to Trello workspace data and common board-management actions. Its toolset covers board discovery, board metadata, lists, cards, members, labels, custom field definitions, checklists, attachments, comments, activity history, and cross-content search.

Read operations can locate accessible boards, inspect lists and cards, retrieve member or label information, and search boards, cards, members, and organizations. Write operations can create and modify cards and lists, move cards between lists, add comments, assign or remove members, manage labels, upload or delete attachments, and edit checklist data. The available tools also include card archiving and checklist-item operations described in the project README.

When `get_card` encounters image attachments, the server downloads those images and returns them as inline MCP image content blocks in addition to the card data. This can make Trello card visuals available to clients that support MCP image content.

## How it works

The server uses stdio transport, so the MCP client starts it as a local process. Trello access is made with the API key and token associated with a Trello Power-Up. Credentials can be supplied globally through `TRELLO_API_KEY` and `TRELLO_TOKEN`, or passed as `apiKey` and `token` tool parameters; request-level values take precedence over environment variables.

Several retrieval tools support compact responses. Compact mode is enabled by default for board details, board cards, list cards, and search, reducing the returned fields. Set `compact` to `false` when descriptions, labels, members, or custom fields are needed. For board exploration, the README recommends starting with board metadata and lists, then retrieving individual cards or list cards rather than requesting full details for large boards.

## Setup and configuration

Install the published npm package with `npx -y atlassian-trello-mcp`. The client configuration must provide the two Trello credential variables. Claude Desktop configuration uses an `mcpServers` entry with `command` set to `npx` and arguments containing `-y` and `atlassian-trello-mcp`.

Before configuring the client, create a Trello Power-Up, generate its API key, and authorize a token with the required read, write, and account scopes. The project README notes that each user must create their own Power-Up and token.

Set `TRELLO_READ_ONLY=true` to disable write operations and expose only read/query tools. This is appropriate when an agent should inspect workspace data without changing Trello.

## Tools and capabilities

The agrath/Trello-Desktop-MCP MCP server includes tools for:

- Finding boards, cards, members, organizations, lists, and other Trello content through search.
- Inspecting boards, lists, cards, members, labels, custom fields, activity, and attachments.
- Creating cards and lists, updating card properties, moving or archiving cards, and adding comments.
- Creating, updating, assigning, removing, and deleting labels.
- Managing card members, checklists, checklist items, and card attachments.
- Uploading a local file or attaching a URL to a card.

## Limitations and notes

The server requires Trello credentials; it does not provide anonymous Trello access. Image attachment handling is tied to `get_card` and depends on the client supporting inline MCP image content. Full-detail responses may return more data than compact responses, so the README advises using them selectively, particularly for larger boards.

The npm package and repository are presented as an active fork, published under the package name `atlassian-trello-mcp`. The documented compatible clients include Claude Desktop, Claude Code, and Gemini CLI; this listing specifically identifies Claude Desktop among the supported client options.

_Full upstream README: https://allmcps.com/mcp/agrath-trello-desktop-mcp/readme_