Trello MCP Server
Trello boards, cards, and comments managed directly through AI agents.
Data last scanned today · Reviewed yesterday
Overview
Trello MCP Server acts as an interface for Trello, allowing AI agents to perform complex operations like managing board activities, extracting comprehensive card data, and handling attachments. The server is built with TypeScript and utilizes the Bun runtime for increased performance. It features built-in rate limiting to manage Trello API constraints, input validation for API interactions, and dynamic board switching capabilities. The server supports a range of actions, including commenting on cards, attaching files via URLs, and exporting data in markdown format.
Our verdict
With a high-risk security score of 30/100, this server should be used with significant caution. It lacks any formal authentication mechanism, meaning anyone with access to the configuration can execute commands on your Trello account. Furthermore, the absence of a read-only mode grants every installation full write access to your data, which may be inappropriate for environments requiring granular permission controls.
- Built on the high-performance Bun runtime
- Includes robust built-in Trello API rate limiting
- Provides comprehensive extraction of card metadata
- Features only five direct dependencies
- No authentication mechanism implemented
- Lacks a read-only mode for restricted access
- Community-maintained rather than official Trello software
- Missing a configured homepage link
Setup
{
"mcpServers": {
"mcp-server-trello": {
"args": [
"-y",
"@delorenj/mcp-server-trello"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| get_checklist_items | Get all items from a checklist by name. | low |
| add_checklist_item | Add a new item to an existing checklist. | medium |
| find_checklist_items_by_description | Search for checklist items containing specific text. | low |
| get_acceptance_criteria | Get all items from the "Acceptance Criteria" checklist. | low |
| get_checklist_by_name | Get a complete checklist with all items and completion percentage. | low |
| update_checklist_item | Update an existing checklist item. | medium |
| delete_checklist_item | Delete an existing checklist item. | high |
| get_card | Get comprehensive details of a specific Trello card with human-level parity. | low |
| get_cards_by_list_id | Fetch all cards from a specific list. | low |
| get_lists | Retrieve all lists from a board. | low |
| get_recent_activity | Fetch recent activity on a board. | low |
| add_card_to_list | Add a new card to a specified list. | medium |
| update_card_details | Update an existing card's details. | medium |
| archive_card | Send a card to the archive. | medium |
| add_list_to_board | Add a new list to a board. | medium |
| archive_list | Send a list to the archive. | medium |
| update_list | Update a list's name, archive state, subscription state, or board. | medium |
| update_list_position | Update the position of a list on the board. | medium |
| get_my_cards | Fetch all cards assigned to the current user. | low |
| move_card | Move a card to a different list. | medium |
| attach_image_to_card | Attach an image to a card directly from a URL. | medium |
| attach_file_to_card | Attach any type of file to a card from a URL or a local file path. | medium |
| download_attachment | Download an attachment from a card by ID. | low |
| add_comment | Add a comment to a Trello card. | medium |
| update_comment | Update an existing comment on a card. | medium |
| delete_comment | Delete a comment from a card. | high |
| get_card_comments | Retrieve all comments from a specific card without fetching all card data. | low |
| list_boards | List all boards the user has access to. | low |
| set_active_board | Set the active board for future operations. | low |
| list_workspaces | List all workspaces the user has access to. | low |
| set_active_workspace | Set the active workspace for future operations. | low |
| list_boards_in_workspace | List all boards in a specific workspace. | low |
| get_active_board_info | Get information about the currently active board. | low |
| get_board_custom_fields | Get all custom field definitions on a board. | low |
| update_card_custom_field | Set or clear a custom field value on a card. | medium |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What authentication is required to use this MCP server?
You must provide your Trello API Key and Trello Token as environment variables in a .env file.
›Can I restrict the server to only access specific Trello workspaces?
Yes, you can define a comma-separated list of workspace IDs in the TRELLO_ALLOWED_WORKSPACES environment variable to limit access.
›Does the server support corporate proxy environments?
Yes, you can configure the server to use a proxy by setting the https_proxy or HTTPS_PROXY environment variable.
›How do I switch between different Trello boards?
You can either provide a boardId parameter in each API call or use the set_active_board tool to change the board dynamically without restarting.
›What is the recommended way for an AI agent to install this server?
The server is distributed as a skill package; agents should follow the instructions in skill/SKILL.md, which executes an automated install.sh script.
Alternatives
Changelog
- Fixv1.6.1 - Patch: CHANGELOG Fix
2025-10-16
- Newv1.6.0 - Complete Comment Management
2025-10-16
- Fixv1.0.0
2025-07-17
Badge
Maintain this server? Add the live badge to your README.