Best for
- Teams that need AI agents to access Trello and manage project tasks.
- Developers who want to automate board workflows with AI assistants.
M
MCP Server Trello
Community
MCP server providing AI agents full access to Trello boards
GitHub source repository ↗
58FMRS · C
This server provides comprehensive Trello integration with 57 tools covering checklists, attachments, comments, and custom fields. It supports dynamic board and workspace selection and built-in rate limiting. The only potential drawback is reliance on Bun and high-level API credentials.
A Model Context Protocol (MCP) server that gives AI agents full access to your Trello boards — cards, lists, checklists, attachments, comments, custom fields, and workspaces — with built-in rate limiting, type safety, and workflow-level tools you won't find in a plain API wrapper, like acceptance-criteria extraction and checklist dependency queries. 57 tools, one npx install, powered by Bun.
Tools
get_checklist_items
Get all items from a checklist by name.
add_checklist_item
Add a new item to an existing checklist.
find_checklist_items_by_description
Search for checklist items containing specific text.
get_acceptance_criteria
Get all items from the 'Acceptance Criteria' checklist.
get_checklist_by_name
Get a complete checklist with all items and completion percentage.
update_checklist_item
Update an existing checklist item.
delete_checklist_item
Delete an existing checklist item.
get_card
Get comprehensive details of a specific Trello card.
get_cards_by_list_id
Fetch all cards from a specific list.
get_lists
Retrieve all lists from a board.
get_recent_activity
Fetch recent activity on a board.
add_card_to_list
Add a new card to a specified list.
update_card_details
Update an existing card's details.
archive_card
Send a card to the archive.
add_list_to_board
Add a new list to a board.
archive_list
Send a list to the archive.
update_list
Update a list's name, archive state, subscription state, or board.
update_list_position
Update the position of a list on the board.
get_my_cards
Fetch all cards assigned to the current user.
move_card
Move a card to a different list.
attach_image_to_card
Attach an image to a card directly from a URL.
attach_file_to_card
Attach any type of file to a card from a URL or a local file path.
download_attachment
Download an attachment from a card by ID.
add_comment
Add a comment to a Trello card.
update_comment
Update an existing comment on a card.
delete_comment
Delete a comment from a card.
get_card_comments
Retrieve all comments from a specific card.
list_boards
List all boards the user has access to.
set_active_board
Set the active board for future operations.
list_workspaces
List all workspaces the user has access to.
set_active_workspace
Set the active workspace for future operations.
list_boards_in_workspace
List all boards in a specific workspace.
get_active_board_info
Get information about the currently active board.
get_board_custom_fields
Get all custom field definitions on a board.
update_card_custom_field
Set or clear a custom field value on a card.
Setup
- Obtain your Trello API key and token from https://trello.com/app-key.
- Add the server to your MCP client configuration, e.g., Claude Desktop config.
- Start the server using bunx or npx, setting environment variables TRELLO_API_KEY and TRELLO_TOKEN.
claude_desktop_config.json
{
"mcpServers": {
"trello": {
"command": "bunx",
"args": [
"@delorenj/mcp-server-trello"
],
"env": {
"TRELLO_API_KEY": "your-trello-api-key",
"TRELLO_TOKEN": "your-trello-token"
}
}
}
}
Fit and risk
Not for
- Scenarios requiring only read-only access without real-time interaction.
- Environments with high performance requirements that cannot tolerate Bun dependency.
Required permissions
- Requires Trello API key and token to access Trello data on behalf of the user.
- By default, can access all boards and workspaces the token has access to.
- Optional restriction to specific workspaces via environment variable TRELLO_ALLOWED_WORKSPACES.
Risks and side effects
- Risk of API credential leakage; handle keys and tokens securely.
- AI may accidentally perform destructive operations, such as deleting cards or comments.
- Improper use may trigger Trello rate limits.
Troubleshooting
- Common troubleshooting checks: - Ensure TRELLO_API_KEY and TRELLO_TOKEN are correct. - Check network connectivity to Trello API. - If rate limited, wait and retry. - Review error messages to confirm board/list/card IDs are valid.
Use cases
Manage boards, lists, and cards via AI assistants.
Extract acceptance criteria from cards.
Automate comments and attachment operations.
Switch between multiple workspaces and boards dynamically.
Supported clients
Claude DesktopFull support