Trello MCP Server with Python

Instructions

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.

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)