update_card
Modify Trello card attributes such as name, description, due dates, members, labels, and position to keep project tasks current and organized.
Instructions
Updates a card's attributes.
Args:
card_id (str): The ID of the card to update.
**kwargs: Keyword arguments representing the attributes to update on the card.
Returns:
TrelloCard: The updated card object.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| card_id | Yes | ||
| payload | Yes |
Implementation Reference
- server/tools/card.py:86-109 (handler)The main MCP tool handler for update_card. It takes context, card_id, and payload, logs the action, calls the CardService to update the card via Trello API, handles errors with ctx.error, and returns the updated TrelloCard.
async def update_card( ctx: Context, card_id: str, payload: UpdateCardPayload ) -> TrelloCard: """Updates a card's attributes. Args: card_id (str): The ID of the card to update. **kwargs: Keyword arguments representing the attributes to update on the card. Returns: TrelloCard: The updated card object. """ try: logger.info(f"Updating card: {card_id} with payload: {payload}") result = await service.update_card( card_id, **payload.model_dump(exclude_unset=True) ) logger.info(f"Successfully updated card: {card_id}") return result except Exception as e: error_msg = f"Failed to update card: {str(e)}" logger.error(error_msg) await ctx.error(error_msg) raise - server/dtos/update_card.py:4-35 (schema)Pydantic BaseModel schema defining the optional fields for the update_card tool input payload.
class UpdateCardPayload(BaseModel): """ Payload for updating a card. Attributes: name (str): The name of the card. desc (str): The description of the card. closed (bool): Whether the card is closed or not. idMembers (str): Comma-separated list of member IDs for the card. idList (str): The ID of the list the card is in. idLabels (str): Comma-separated list of label IDs for the card. idBoard (str): The ID of the board the card is in. pos (str | int): The position of the card. due (str): The due date of the card in ISO 8601 format. start (str): The start date of the card in ISO 8601 format. dueComplete (bool): Whether the card is due complete or not. subscribed (bool): Whether the card is subscribed or not. """ name: str | None = None desc: str | None = None closed: bool | None = None idMembers: str | None = None idList: str | None = None idLabels: str | None = None idBoard: str | None = None pos: str | None = None due: str | None = None start: str | None = None dueComplete: bool | None = None subscribed: bool | None = None - server/tools/tools.py:27-27 (registration)Registers the update_card tool handler from the card module with the MCP server instance.
mcp.add_tool(card.update_card) - server/services/card.py:57-69 (helper)CardService helper method that makes the actual Trello API PUT request to update the card and returns the updated TrelloCard model.
async def update_card(self, card_id: str, **kwargs) -> TrelloCard: """Updates a card's attributes. Args: card_id (str): The ID of the card to update. **kwargs: Keyword arguments representing the attributes to update on the card. Returns: TrelloCard: The updated card object. """ response = await self.client.PUT(f"/cards/{card_id}", data=kwargs) return TrelloCard(**response)