add trello mcp server

pmcp/trello_server/dtos/update_card.py

@@ -0,0 +1,22 @@
+from pydantic import BaseModel
+
+
+class UpdateCardPayload(BaseModel):
+    """
+    Payload for updating a card.
+
+    Attributes:
+        name (str): The name of the card.
+        desc (str): The description of the card.
+        pos (str | int): The position of the card.
+        closed (bool): Whether the card is closed or not.
+        due (str): The due date of the card in ISO 8601 format.
+        idLabels (str): Comma-separated list of label IDs for the card.
+    """
+
+    name: str | None = None
+    desc: str | None = None
+    pos: str | None = None
+    closed: bool | None = None
+    due: str | None = None
+    idLabels: str | None = None

pmcp/trello_server/models.py

@@ -0,0 +1,47 @@
+from typing import List, Optional
+
+from pydantic import BaseModel
+
+
+class TrelloBoard(BaseModel):
+    """Model representing a Trello board."""
+
+    id: str
+    name: str
+    desc: Optional[str] = None
+    closed: bool = False
+    idOrganization: Optional[str] = None
+    url: str
+
+
+class TrelloList(BaseModel):
+    """Model representing a Trello list."""
+
+    id: str
+    name: str
+    closed: bool = False
+    idBoard: str
+    pos: float
+
+
+class TrelloLabel(BaseModel):
+    """Model representing a Trello label."""
+    
+    id: str
+    name: str
+    color: Optional[str] = None
+
+
+class TrelloCard(BaseModel):
+    """Model representing a Trello card."""
+
+    id: str
+    name: str
+    desc: Optional[str] = None
+    closed: bool = False
+    idList: str
+    idBoard: str
+    url: str
+    pos: float
+    labels: List[TrelloLabel] = []
+    due: Optional[str] = None

pmcp/trello_server/services/board.py

@@ -0,0 +1,53 @@
+"""
+Service for managing Trello boards in MCP server.
+"""
+
+from typing import List
+
+from pmcp.trello_server.models import TrelloBoard, TrelloLabel
+from pmcp.trello_server.utils.trello_api import TrelloClient
+
+
+class BoardService:
+    """
+    Service class for managing Trello boards
+    """
+
+    def __init__(self, client: TrelloClient):
+        self.client = client
+
+    async def get_board(self, board_id: str) -> TrelloBoard:
+        """Retrieves a specific board by its ID.
+
+        Args:
+            board_id (str): The ID of the board to retrieve.
+
+        Returns:
+            TrelloBoard: The board object containing board details.
+        """
+        response = await self.client.GET(f"/boards/{board_id}")
+        return TrelloBoard(**response)
+
+    async def get_boards(self, member_id: str = "me") -> List[TrelloBoard]:
+        """Retrieves all boards for a given member.
+
+        Args:
+            member_id (str): The ID of the member whose boards to retrieve. Defaults to "me" for the authenticated user.
+
+        Returns:
+            List[TrelloBoard]: A list of board objects.
+        """
+        response = await self.client.GET(f"/members/{member_id}/boards")
+        return [TrelloBoard(**board) for board in response]
+
+    async def get_board_labels(self, board_id: str) -> List[TrelloLabel]:
+        """Retrieves all labels for a specific board.
+
+        Args:
+            board_id (str): The ID of the board whose labels to retrieve.
+
+        Returns:
+            List[TrelloLabel]: A list of label objects for the board.
+        """
+        response = await self.client.GET(f"/boards/{board_id}/labels")
+        return [TrelloLabel(**label) for label in response]

pmcp/trello_server/services/card.py

@@ -0,0 +1,84 @@
+"""
+Service for managing Trello cards in MCP server.
+"""
+
+from typing import Any, Dict, List
+
+from pmcp.trello_server.models import TrelloCard
+from pmcp.trello_server.utils.trello_api import TrelloClient
+
+
+class CardService:
+    """
+    Service class for managing Trello cards.
+    """
+
+    def __init__(self, client: TrelloClient):
+        self.client = client
+
+    async def get_card(self, card_id: str) -> TrelloCard:
+        """Retrieves a specific card by its ID.
+
+        Args:
+            card_id (str): The ID of the card to retrieve.
+
+        Returns:
+            TrelloCard: The card object containing card details.
+        """
+        response = await self.client.GET(f"/cards/{card_id}")
+        return TrelloCard(**response)
+
+    async def get_cards(self, list_id: str) -> List[TrelloCard]:
+        """Retrieves all cards in a given list.
+
+        Args:
+            list_id (str): The ID of the list whose cards to retrieve.
+
+        Returns:
+            List[TrelloCard]: A list of card objects.
+        """
+        response = await self.client.GET(f"/lists/{list_id}/cards")
+        return [TrelloCard(**card) for card in response]
+
+    async def create_card(
+        self, list_id: str, name: str, desc: str | None = None
+    ) -> TrelloCard:
+        """Creates a new card in a given list.
+
+        Args:
+            list_id (str): The ID of the list to create the card in.
+            name (str): The name of the new card.
+            desc (str, optional): The description of the new card. Defaults to None.
+
+        Returns:
+            TrelloCard: The newly created card object.
+        """
+        data = {"name": name, "idList": list_id}
+        if desc:
+            data["desc"] = desc
+        response = await self.client.POST("/cards", data=data)
+        return TrelloCard(**response)
+
+    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)
+
+    async def delete_card(self, card_id: str) -> Dict[str, Any]:
+        """Deletes a card.
+
+        Args:
+            card_id (str): The ID of the card to delete.
+
+        Returns:
+            Dict[str, Any]: The response from the delete operation.
+        """
+        return await self.client.DELETE(f"/cards/{card_id}")

pmcp/trello_server/services/checklist.py

@@ -0,0 +1,164 @@
+import logging
+from typing import Dict, List, Optional
+
+from pmcp.trello_server.utils.trello_api import TrelloClient
+
+logger = logging.getLogger(__name__)
+
+
+class ChecklistService:
+    """
+    Service class for handling Trello checklist operations.
+    """
+
+    def __init__(self, client: TrelloClient):
+        self.client = client
+
+    async def get_checklist(self, checklist_id: str) -> Dict:
+        """
+        Get a specific checklist by ID.
+
+        Args:
+            checklist_id (str): The ID of the checklist to retrieve
+
+        Returns:
+            Dict: The checklist data
+        """
+        return await self.client.GET(f"/checklists/{checklist_id}")
+
+    async def get_card_checklists(self, card_id: str) -> List[Dict]:
+        """
+        Get all checklists for a specific card.
+
+        Args:
+            card_id (str): The ID of the card to get checklists for
+
+        Returns:
+            List[Dict]: List of checklists on the card
+        """
+        return await self.client.GET(f"/cards/{card_id}/checklists")
+
+    async def create_checklist(
+        self, card_id: str, name: str, pos: Optional[str] = None
+    ) -> Dict:
+        """
+        Create a new checklist on a card.
+
+        Args:
+            card_id (str): The ID of the card to create the checklist on
+            name (str): The name of the checklist
+            pos (Optional[str]): The position of the checklist (top, bottom, or a positive number)
+
+        Returns:
+            Dict: The created checklist data
+        """
+        data = {"name": name}
+        if pos:
+            data["pos"] = pos
+        return await self.client.POST(f"/checklists", data={"idCard": card_id, **data})
+
+    async def update_checklist(
+        self, checklist_id: str, name: Optional[str] = None, pos: Optional[str] = None
+    ) -> Dict:
+        """
+        Update an existing checklist.
+
+        Args:
+            checklist_id (str): The ID of the checklist to update
+            name (Optional[str]): New name for the checklist
+            pos (Optional[str]): New position for the checklist
+
+        Returns:
+            Dict: The updated checklist data
+        """
+        data = {}
+        if name:
+            data["name"] = name
+        if pos:
+            data["pos"] = pos
+        return await self.client.PUT(f"/checklists/{checklist_id}", data=data)
+
+    async def delete_checklist(self, checklist_id: str) -> Dict:
+        """
+        Delete a checklist.
+
+        Args:
+            checklist_id (str): The ID of the checklist to delete
+
+        Returns:
+            Dict: The response from the delete operation
+        """
+        return await self.client.DELETE(f"/checklists/{checklist_id}")
+
+    async def add_checkitem(
+        self,
+        checklist_id: str,
+        name: str,
+        checked: bool = False,
+        pos: Optional[str] = None,
+    ) -> Dict:
+        """
+        Add a new item to a checklist.
+
+        Args:
+            checklist_id (str): The ID of the checklist to add the item to
+            name (str): The name of the checkitem
+            checked (bool): Whether the item is checked
+            pos (Optional[str]): The position of the item
+
+        Returns:
+            Dict: The created checkitem data
+        """
+        data = {"name": name, "checked": checked}
+        if pos:
+            data["pos"] = pos
+        return await self.client.POST(
+            f"/checklists/{checklist_id}/checkItems", data=data
+        )
+
+    async def update_checkitem(
+        self,
+        checklist_id: str,
+        checkitem_id: str,
+        name: Optional[str] = None,
+        checked: Optional[bool] = None,
+        pos: Optional[str] = None,
+    ) -> Dict:
+        """
+        Update a checkitem in a checklist.
+
+        Args:
+            checklist_id (str): The ID of the checklist containing the item
+            checkitem_id (str): The ID of the checkitem to update
+            name (Optional[str]): New name for the checkitem
+            checked (Optional[bool]): New checked state
+            pos (Optional[str]): New position for the item
+
+        Returns:
+            Dict: The updated checkitem data
+        """
+        data = {}
+        if name:
+            data["name"] = name
+        if checked is not None:
+            data["checked"] = checked
+        if pos:
+            data["pos"] = pos
+        return await self.client.PUT(
+            f"/checklists/{checklist_id}/checkItems/{checkitem_id}", data=data
+        )
+
+    async def delete_checkitem(self, checklist_id: str, checkitem_id: str) -> Dict:
+        """
+        Delete a checkitem from a checklist.
+
+        Args:
+            checklist_id (str): The ID of the checklist containing the item
+            checkitem_id (str): The ID of the checkitem to delete
+
+        Returns:
+            Dict: The response from the delete operation
+        """
+        return await self.client.DELETE(
+            f"/checklists/{checklist_id}/checkItems/{checkitem_id}"
+        )

pmcp/trello_server/services/list.py

@@ -0,0 +1,82 @@
+from typing import List
+
+from pmcp.trello_server.models import TrelloList
+from pmcp.trello_server.utils.trello_api import TrelloClient
+
+
+class ListService:
+    """
+    Service class for managing Trello lists.
+    """
+
+    def __init__(self, client: TrelloClient):
+        self.client = client
+
+    # Lists
+    async def get_list(self, list_id: str) -> TrelloList:
+        """Retrieves a specific list by its ID.
+
+        Args:
+            list_id (str): The ID of the list to retrieve.
+
+        Returns:
+            TrelloList: The list object containing list details.
+        """
+        response = await self.client.GET(f"/lists/{list_id}")
+        return TrelloList(**response)
+
+    async def get_lists(self, board_id: str) -> List[TrelloList]:
+        """Retrieves all lists on a given board.
+
+        Args:
+            board_id (str): The ID of the board whose lists to retrieve.
+
+        Returns:
+            List[TrelloList]: A list of list objects.
+        """
+        response = await self.client.GET(f"/boards/{board_id}/lists")
+        return [TrelloList(**list_data) for list_data in response]
+
+    async def create_list(
+        self, board_id: str, name: str, pos: str = "bottom"
+    ) -> TrelloList:
+        """Creates a new list on a given board.
+
+        Args:
+            board_id (str): The ID of the board to create the list in.
+            name (str): The name of the new list.
+            pos (str, optional): The position of the new list. Can be "top" or "bottom". Defaults to "bottom".
+
+        Returns:
+            TrelloList: The newly created list object.
+        """
+        data = {"name": name, "idBoard": board_id, "pos": pos}
+        response = await self.client.POST("/lists", data=data)
+        return TrelloList(**response)
+
+    async def update_list(self, list_id: str, name: str) -> TrelloList:
+        """Updates the name of a list.
+
+        Args:
+            list_id (str): The ID of the list to update.
+            name (str): The new name for the list.
+
+        Returns:
+            TrelloList: The updated list object.
+        """
+        response = await self.client.PUT(f"/lists/{list_id}", data={"name": name})
+        return TrelloList(**response)
+
+    async def delete_list(self, list_id: str) -> TrelloList:
+        """Archives a list.
+
+        Args:
+            list_id (str): The ID of the list to close.
+
+        Returns:
+            TrelloList: The archived list object.
+        """
+        response = await self.client.PUT(
+            f"/lists/{list_id}/closed", data={"value": "true"}
+        )
+        return TrelloList(**response)

pmcp/trello_server/tools/__init__.py

@@ -0,0 +1 @@
+

pmcp/trello_server/tools/board.py

@@ -0,0 +1,76 @@
+"""
+This module contains tools for managing Trello boards.
+"""
+
+import logging
+from typing import List
+
+from mcp.server.fastmcp import Context
+
+from pmcp.trello_server.models import TrelloBoard, TrelloLabel
+from pmcp.trello_server.services.board import BoardService
+from pmcp.trello_server.trello import client
+
+logger = logging.getLogger(__name__)
+
+service = BoardService(client)
+
+
+async def get_board(ctx: Context, board_id: str) -> TrelloBoard:
+    """Retrieves a specific board by its ID.
+
+    Args:
+        board_id (str): The ID of the board to retrieve.
+
+    Returns:
+        TrelloBoard: The board object containing board details.
+    """
+    try:
+        logger.info(f"Getting board with ID: {board_id}")
+        result = await service.get_board(board_id)
+        logger.info(f"Successfully retrieved board: {board_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to get board: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+async def get_boards(ctx: Context) -> List[TrelloBoard]:
+    """Retrieves all boards for the authenticated user.
+
+    Returns:
+        List[TrelloBoard]: A list of board objects.
+    """
+    try:
+        logger.info("Getting all boards")
+        result = await service.get_boards()
+        logger.info(f"Successfully retrieved {len(result)} boards")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to get boards: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+async def get_board_labels(ctx: Context, board_id: str) -> List[TrelloLabel]:
+    """Retrieves all labels for a specific board.
+
+    Args:
+        board_id (str): The ID of the board whose labels to retrieve.
+
+    Returns:
+        List[TrelloLabel]: A list of label objects for the board.
+    """
+    try:
+        logger.info(f"Getting labels for board: {board_id}")
+        result = await service.get_board_labels(board_id)
+        logger.info(f"Successfully retrieved {len(result)} labels for board: {board_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to get board labels: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise

pmcp/trello_server/tools/card.py

@@ -0,0 +1,131 @@
+"""
+This module contains tools for managing Trello cards.
+"""
+
+import logging
+from typing import List
+
+from mcp.server.fastmcp import Context
+
+from pmcp.trello_server.models import TrelloCard
+from pmcp.trello_server.services.card import CardService
+from pmcp.trello_server.trello import client
+from pmcp.trello_server.dtos.update_card import UpdateCardPayload
+
+logger = logging.getLogger(__name__)
+
+service = CardService(client)
+
+
+async def get_card(ctx: Context, card_id: str) -> TrelloCard:
+    """Retrieves a specific card by its ID.
+
+    Args:
+        card_id (str): The ID of the card to retrieve.
+
+    Returns:
+        TrelloCard: The card object containing card details.
+    """
+    try:
+        logger.info(f"Getting card with ID: {card_id}")
+        result = await service.get_card(card_id)
+        logger.info(f"Successfully retrieved card: {card_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to get card: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+async def get_cards(ctx: Context, list_id: str) -> List[TrelloCard]:
+    """Retrieves all cards in a given list.
+
+    Args:
+        list_id (str): The ID of the list whose cards to retrieve.
+
+    Returns:
+        List[TrelloCard]: A list of card objects.
+    """
+    try:
+        logger.info(f"Getting cards for list: {list_id}")
+        result = await service.get_cards(list_id)
+        logger.info(f"Successfully retrieved {len(result)} cards for list: {list_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to get cards: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+async def create_card(
+    ctx: Context, list_id: str, name: str, desc: str | None = None
+) -> TrelloCard:
+    """Creates a new card in a given list.
+
+    Args:
+        list_id (str): The ID of the list to create the card in.
+        name (str): The name of the new card.
+        desc (str, optional): The description of the new card. Defaults to None.
+
+    Returns:
+        TrelloCard: The newly created card object.
+    """
+    try:
+        logger.info(f"Creating card in list {list_id} with name: {name}")
+        result = await service.create_card(list_id, name, desc)
+        logger.info(f"Successfully created card in list: {list_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to create card: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+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
+
+
+async def delete_card(ctx: Context, card_id: str) -> dict:
+    """Deletes a card.
+
+    Args:
+        card_id (str): The ID of the card to delete.
+
+    Returns:
+        dict: The response from the delete operation.
+    """
+    try:
+        logger.info(f"Deleting card: {card_id}")
+        result = await service.delete_card(card_id)
+        logger.info(f"Successfully deleted card: {card_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to delete card: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise

pmcp/trello_server/tools/checklist.py

@@ -0,0 +1,140 @@
+"""
+This module contains tools for managing Trello checklists.
+"""
+
+import logging
+from typing import Dict, List, Optional
+
+from pmcp.trello_server.services.checklist import ChecklistService
+from pmcp.trello_server.trello import client
+
+logger = logging.getLogger(__name__)
+service = ChecklistService(client)
+
+
+async def get_checklist(checklist_id: str) -> Dict:
+    """
+    Get a specific checklist by ID.
+
+    Args:
+        checklist_id (str): The ID of the checklist to retrieve
+
+    Returns:
+        Dict: The checklist data
+    """
+    return await service.get_checklist(checklist_id)
+
+
+async def get_card_checklists(card_id: str) -> List[Dict]:
+    """
+    Get all checklists for a specific card.
+
+    Args:
+        card_id (str): The ID of the card to get checklists for
+
+    Returns:
+        List[Dict]: List of checklists on the card
+    """
+    return await service.get_card_checklists(card_id)
+
+
+async def create_checklist(card_id: str, name: str, pos: Optional[str] = None) -> Dict:
+    """
+    Create a new checklist on a card.
+
+    Args:
+        card_id (str): The ID of the card to create the checklist on
+        name (str): The name of the checklist
+        pos (Optional[str]): The position of the checklist (top, bottom, or a positive number)
+
+    Returns:
+        Dict: The created checklist data
+    """
+    return await service.create_checklist(card_id, name, pos)
+
+
+async def update_checklist(
+    checklist_id: str, name: Optional[str] = None, pos: Optional[str] = None
+) -> Dict:
+    """
+    Update an existing checklist.
+
+    Args:
+        checklist_id (str): The ID of the checklist to update
+        name (Optional[str]): New name for the checklist
+        pos (Optional[str]): New position for the checklist
+
+    Returns:
+        Dict: The updated checklist data
+    """
+    return await service.update_checklist(checklist_id, name, pos)
+
+
+async def delete_checklist(checklist_id: str) -> Dict:
+    """
+    Delete a checklist.
+
+    Args:
+        checklist_id (str): The ID of the checklist to delete
+
+    Returns:
+        Dict: The response from the delete operation
+    """
+    return await service.delete_checklist(checklist_id)
+
+
+async def add_checkitem(
+    checklist_id: str, name: str, checked: bool = False, pos: Optional[str] = None
+) -> Dict:
+    """
+    Add a new item to a checklist.
+
+    Args:
+        checklist_id (str): The ID of the checklist to add the item to
+        name (str): The name of the checkitem
+        checked (bool): Whether the item is checked
+        pos (Optional[str]): The position of the item
+
+    Returns:
+        Dict: The created checkitem data
+    """
+    return await service.add_checkitem(checklist_id, name, checked, pos)
+
+
+async def update_checkitem(
+    checklist_id: str,
+    checkitem_id: str,
+    name: Optional[str] = None,
+    checked: Optional[bool] = None,
+    pos: Optional[str] = None,
+) -> Dict:
+    """
+    Update a checkitem in a checklist.
+
+    Args:
+        checklist_id (str): The ID of the checklist containing the item
+        checkitem_id (str): The ID of the checkitem to update
+        name (Optional[str]): New name for the checkitem
+        checked (Optional[bool]): New checked state
+        pos (Optional[str]): New position for the item
+
+    Returns:
+        Dict: The updated checkitem data
+    """
+    return await service.update_checkitem(
+        checklist_id, checkitem_id, name, checked, pos
+    )
+
+
+async def delete_checkitem(checklist_id: str, checkitem_id: str) -> Dict:
+    """
+    Delete a checkitem from a checklist.
+
+    Args:
+        checklist_id (str): The ID of the checklist containing the item
+        checkitem_id (str): The ID of the checkitem to delete
+
+    Returns:
+        Dict: The response from the delete operation
+    """
+    return await service.delete_checkitem(checklist_id, checkitem_id)

pmcp/trello_server/tools/list.py

@@ -0,0 +1,127 @@
+"""
+This module contains tools for managing Trello lists.
+"""
+
+import logging
+from typing import List
+
+from mcp.server.fastmcp import Context
+
+from pmcp.trello_server.models import TrelloList
+from pmcp.trello_server.services.list import ListService
+from pmcp.trello_server.trello import client
+
+logger = logging.getLogger(__name__)
+
+service = ListService(client)
+
+
+# List Tools
+async def get_list(ctx: Context, list_id: str) -> TrelloList:
+    """Retrieves a specific list by its ID.
+
+    Args:
+        list_id (str): The ID of the list to retrieve.
+
+    Returns:
+        TrelloList: The list object containing list details.
+    """
+    try:
+        logger.info(f"Getting list with ID: {list_id}")
+        result = await service.get_list(list_id)
+        logger.info(f"Successfully retrieved list: {list_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to get list: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+async def get_lists(ctx: Context, board_id: str) -> List[TrelloList]:
+    """Retrieves all lists on a given board.
+
+    Args:
+        board_id (str): The ID of the board whose lists to retrieve.
+
+    Returns:
+        List[TrelloList]: A list of list objects.
+    """
+    try:
+        logger.info(f"Getting lists for board: {board_id}")
+        result = await service.get_lists(board_id)
+        logger.info(f"Successfully retrieved {len(result)} lists for board: {board_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to get lists: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+async def create_list(
+    ctx: Context, board_id: str, name: str, pos: str = "bottom"
+) -> TrelloList:
+    """Creates a new list on a given board.
+
+    Args:
+        board_id (str): The ID of the board to create the list in.
+        name (str): The name of the new list.
+        pos (str, optional): The position of the new list. Can be "top" or "bottom". Defaults to "bottom".
+
+    Returns:
+        TrelloList: The newly created list object.
+    """
+    try:
+        logger.info(f"Creating list '{name}' in board: {board_id}")
+        result = await service.create_list(board_id, name, pos)
+        logger.info(f"Successfully created list '{name}' in board: {board_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to create list: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+async def update_list(ctx: Context, list_id: str, name: str) -> TrelloList:
+    """Updates the name of a list.
+
+    Args:
+        list_id (str): The ID of the list to update.
+        name (str): The new name for the list.
+
+    Returns:
+        TrelloList: The updated list object.
+    """
+    try:
+        logger.info(f"Updating list {list_id} with new name: {name}")
+        result = await service.update_list(list_id, name)
+        logger.info(f"Successfully updated list: {list_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to update list: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise
+
+
+async def delete_list(ctx: Context, list_id: str) -> TrelloList:
+    """Archives a list.
+
+    Args:
+        list_id (str): The ID of the list to close.
+
+    Returns:
+        TrelloList: The archived list object.
+    """
+    try:
+        logger.info(f"Archiving list: {list_id}")
+        result = await service.delete_list(list_id)
+        logger.info(f"Successfully archived list: {list_id}")
+        return result
+    except Exception as e:
+        error_msg = f"Failed to delete list: {str(e)}"
+        logger.error(error_msg)
+        await ctx.error(error_msg)
+        raise

pmcp/trello_server/tools/tools.py

@@ -0,0 +1,37 @@
+"""
+This module contains tools for managing Trello boards, lists, and cards.
+"""
+
+from pmcp.trello_server.tools import board, card, checklist, list
+
+
+def register_tools(mcp):
+    """Register tools with the MCP server."""
+    # Board Tools
+    mcp.add_tool(board.get_board)
+    mcp.add_tool(board.get_boards)
+    mcp.add_tool(board.get_board_labels)
+
+    # List Tools
+    mcp.add_tool(list.get_list)
+    mcp.add_tool(list.get_lists)
+    mcp.add_tool(list.create_list)
+    mcp.add_tool(list.update_list)
+    mcp.add_tool(list.delete_list)
+
+    # Card Tools
+    mcp.add_tool(card.get_card)
+    mcp.add_tool(card.get_cards)
+    mcp.add_tool(card.create_card)
+    mcp.add_tool(card.update_card)
+    mcp.add_tool(card.delete_card)
+
+    # Checklist Tools
+    mcp.add_tool(checklist.get_checklist)
+    mcp.add_tool(checklist.get_card_checklists)
+    mcp.add_tool(checklist.create_checklist)
+    mcp.add_tool(checklist.update_checklist)
+    mcp.add_tool(checklist.delete_checklist)
+    mcp.add_tool(checklist.add_checkitem)
+    mcp.add_tool(checklist.update_checkitem)
+    mcp.add_tool(checklist.delete_checkitem)

pmcp/trello_server/trello.py

@@ -0,0 +1,62 @@
+import logging
+import os
+
+from dotenv import load_dotenv
+
+from pmcp.trello_server.utils.trello_api import TrelloClient
+
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO, format="%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+)
+logger = logging.getLogger(__name__)
+
+# Load environment variables
+load_dotenv()
+
+
+# Initialize Trello client and service
+try:
+    api_key = os.getenv("TRELLO_API_KEY")
+    token = os.getenv("TRELLO_TOKEN")
+    if not api_key or not token:
+        raise ValueError(
+            "TRELLO_API_KEY and TRELLO_TOKEN must be set in environment variables"
+        )
+    client = TrelloClient(api_key=api_key, token=token)
+    logger.info("Trello client and service initialized successfully")
+except Exception as e:
+    logger.error(f"Failed to initialize Trello client: {str(e)}")
+    raise
+
+
+# Add a prompt for common Trello operations
+def trello_help() -> str:
+    """Provides help information about available Trello operations."""
+    return """
+    Available Trello Operations:
+    1. Board Operations:
+       - Get a specific board
+       - List all boards
+    2. List Operations:
+       - Get a specific list
+       - List all lists in a board
+       - Create a new list
+       - Update a list's name
+       - Archive a list
+    3. Card Operations:
+       - Get a specific card
+       - List all cards in a list
+       - Create a new card
+       - Update a card's attributes
+       - Delete a card
+    4. Checklist Operations:
+       - Get a specific checklist
+       - List all checklists in a card
+       - Create a new checklist
+       - Update a checklist
+       - Delete a checklist
+       - Add checkitem to checklist
+       - Update checkitem
+       - Delete checkitem
+    """

pmcp/trello_server/utils/trello_api.py

@@ -0,0 +1,96 @@
+# trello_api.py
+import logging
+
+import httpx
+
+# Configure logging
+logger = logging.getLogger(__name__)
+
+TRELLO_API_BASE = "https://api.trello.com/1"
+
+
+class TrelloClient:
+    """
+    Client class for interacting with the Trello API over REST.
+    """
+
+    def __init__(self, api_key: str, token: str):
+        self.api_key = api_key
+        self.token = token
+        self.base_url = TRELLO_API_BASE
+        self.client = httpx.AsyncClient(base_url=self.base_url)
+
+    async def close(self):
+        await self.client.aclose()
+
+    async def GET(self, endpoint: str, params: dict = None):
+        all_params = {"key": self.api_key, "token": self.token}
+        if params:
+            all_params.update(params)
+        try:
+            response = await self.client.get(endpoint, params=all_params)
+            response.raise_for_status()
+            return response.json()
+        except httpx.HTTPStatusError as e:
+            logger.error(f"HTTP error: {e}")
+            raise httpx.HTTPStatusError(
+                f"Failed to get {endpoint}: {str(e)}",
+                request=e.request,
+                response=e.response,
+            )
+        except httpx.RequestError as e:
+            logger.error(f"Request error: {e}")
+            raise httpx.RequestError(f"Failed to get {endpoint}: {str(e)}")
+
+    async def POST(self, endpoint: str, data: dict = None):
+        all_params = {"key": self.api_key, "token": self.token}
+        try:
+            response = await self.client.post(endpoint, params=all_params, json=data)
+            response.raise_for_status()
+            return response.json()
+        except httpx.HTTPStatusError as e:
+            logger.error(f"HTTP error: {e}")
+            raise httpx.HTTPStatusError(
+                f"Failed to post to {endpoint}: {str(e)}",
+                request=e.request,
+                response=e.response,
+            )
+        except httpx.RequestError as e:
+            logger.error(f"Request error: {e}")
+            raise httpx.RequestError(f"Failed to post to {endpoint}: {str(e)}")
+
+    async def PUT(self, endpoint: str, data: dict = None):
+        all_params = {"key": self.api_key, "token": self.token}
+        try:
+            response = await self.client.put(endpoint, params=all_params, json=data)
+            response.raise_for_status()
+            return response.json()
+        except httpx.HTTPStatusError as e:
+            logger.error(f"HTTP error: {e}")
+            raise httpx.HTTPStatusError(
+                f"Failed to put to {endpoint}: {str(e)}",
+                request=e.request,
+                response=e.response,
+            )
+        except httpx.RequestError as e:
+            logger.error(f"Request error: {e}")
+            raise httpx.RequestError(f"Failed to put to {endpoint}: {str(e)}")
+
+    async def DELETE(self, endpoint: str, params: dict = None):
+        all_params = {"key": self.api_key, "token": self.token}
+        if params:
+            all_params.update(params)
+        try:
+            response = await self.client.delete(endpoint, params=all_params)
+            response.raise_for_status()
+            return response.json()
+        except httpx.HTTPStatusError as e:
+            logger.error(f"HTTP error: {e}")
+            raise httpx.HTTPStatusError(
+                f"Failed to delete {endpoint}: {str(e)}",
+                request=e.request,
+                response=e.response,
+            )
+        except httpx.RequestError as e:
+            logger.error(f"Request error: {e}")
+            raise httpx.RequestError(f"Failed to delete {endpoint}: {str(e)}")