How to Integrate AI Agents with Trello

pip install py-trello langchain langchain-openai python-dotenv

export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&key=YOUR_API_KEY

from trello import TrelloClient
import os

client = TrelloClient(
    api_key=os.getenv("TRELLO_API_KEY"),
    token=os.getenv("TRELLO_TOKEN")
)
boards = client.list_boards()
for board in boards:
    print(f"Board: {board.name} (ID: {board.id})")

import os
import requests
from datetime import datetime, timedelta
from langchain.tools import tool
from dotenv import load_dotenv

load_dotenv()

API_KEY = os.getenv("TRELLO_API_KEY")
TOKEN = os.getenv("TRELLO_TOKEN")
BASE_URL = "https://api.trello.com/1"


def trello_request(method: str, endpoint: str, **kwargs) -> dict:
    """Execute a Trello API request with authentication."""
    params = kwargs.pop("params", {})
    params.update({"key": API_KEY, "token": TOKEN})
    response = requests.request(
        method, f"{BASE_URL}/{endpoint}", params=params, **kwargs
    )
    response.raise_for_status()
    return response.json()


@tool
def list_boards_and_lists() -> str:
    """List all Trello boards and their lists with IDs for reference."""
    boards = trello_request("GET", "members/me/boards", params={"fields": "id,name,closed"})
    result = []
    for board in boards:
        if board.get("closed"):
            continue
        lists = trello_request("GET", f"boards/{board['id']}/lists", params={"fields": "id,name,pos"})
        result.append(f"\n{board['name']} (Board ID: {board['id']}):")
        for lst in sorted(lists, key=lambda x: x.get("pos", 0)):
            result.append(f"  - {lst['name']} (List ID: {lst['id']})")
    return "Your Trello boards:" + "\n".join(result) if result else "No active boards found"


@tool
def create_card(list_id: str, name: str, description: str = "",
                due_days: int = None, label_ids: list = None) -> str:
    """
    Create a new Trello card in a specific list.
    due_days: days from today until due date (optional).
    label_ids: list of label IDs to apply (optional).
    """
    data = {"name": name, "desc": description, "idList": list_id}
    if due_days is not None:
        due_date = (datetime.now() + timedelta(days=due_days)).isoformat() + "Z"
        data["due"] = due_date
    if label_ids:
        data["idLabels"] = ",".join(label_ids)

    card = trello_request("POST", "cards", json=data)
    return f"Card created: '{card['name']}' — {card.get('shortUrl', card['id'])}"


@tool
def move_card(card_id: str, target_list_id: str) -> str:
    """Move a Trello card to a different list (e.g., from 'In Progress' to 'Done')."""
    card = trello_request("PUT", f"cards/{card_id}", json={"idList": target_list_id})
    return f"Card '{card['name']}' moved to list {target_list_id}"


@tool
def add_checklist(card_id: str, checklist_name: str, items: list) -> str:
    """Add a checklist with items to a Trello card to track subtasks."""
    checklist = trello_request("POST", "checklists", json={
        "idCard": card_id,
        "name": checklist_name
    })
    checklist_id = checklist["id"]
    for item in items:
        trello_request("POST", f"checklists/{checklist_id}/checkItems", json={"name": item})
    return f"Checklist '{checklist_name}' added to card {card_id} with {len(items)} items"


@tool
def get_list_cards(list_id: str) -> str:
    """Get all open cards in a Trello list."""
    cards = trello_request("GET", f"lists/{list_id}/cards", params={
        "fields": "id,name,desc,due,labels,dateLastActivity",
        "filter": "open"
    })
    if not cards:
        return f"No open cards in list {list_id}"

    result = [f"Cards in list ({len(cards)} open):"]
    for card in cards:
        due = card.get("due", "No due date")
        if due and "T" in due:
            due = datetime.fromisoformat(due.replace("Z", "+00:00")).strftime("%b %d")
        labels = [l.get("name", l.get("color", "")) for l in card.get("labels", [])]
        label_str = f" [{', '.join(labels)}]" if labels else ""
        result.append(f"  [{card['id'][-8:]}] {card['name']}{label_str} | Due: {due}")
    return "\n".join(result)


@tool
def add_comment(card_id: str, comment: str) -> str:
    """Add a comment to a Trello card for updates or AI analysis notes."""
    trello_request("POST", f"cards/{card_id}/actions/comments", json={"text": comment})
    return f"Comment added to card {card_id}"

from langchain_openai import ChatOpenAI
from langchain.agents import create_tool_calling_agent, AgentExecutor
from langchain_core.prompts import ChatPromptTemplate

llm = ChatOpenAI(model="gpt-4o", temperature=0.1)
tools = [list_boards_and_lists, create_card, move_card, add_checklist,
         get_list_cards, add_comment]

prompt = ChatPromptTemplate.from_messages([
    ("system", """You are a kanban workflow assistant with access to Trello.

When creating cards:
1. List boards and lists first to find the right destination
2. Use clear, actionable card names (what to do, not what was done)
3. Add checklists for complex cards to break down the work
4. Set due dates when timing is mentioned

When reviewing boards:
1. Identify cards that have been in 'In Progress' for too long (stale WIP)
2. Check for cards missing labels or due dates
3. Provide specific recommendations, not just observations

Avoid moving cards unless explicitly instructed — just report what needs attention."""),
    ("human", "{input}"),
    ("placeholder", "{agent_scratchpad}"),
])

agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True, max_iterations=6)

# Example: Triage a request
result = executor.invoke({
    "input": "Create a Trello card for this task: 'Write Q1 board presentation for CEO - needs financial charts, product roadmap, and team headcount. Due in 5 days.' Add a checklist with subtasks."
})
print(result["output"])