← All integrations

Trello

Let an agent move cards across your boards without your password. It reads boards, lists and cards, creates, updates, moves, archives and labels cards and comments on them, and deleting a card can wait for a person.

Trellosecret · TRELLO
host
api.trello.com
connect
API key, per user
  • Create card

    trello-create-card

  • Update card

    trello-update-card

  • Move card

    trello-move-card

  • Archive card

    trello-archive-card

writes are off until switched on

Reads and writes in Trello. Writes are off until you switch them on.

Each one is a named operation from the pack. Reads change nothing.

Writes

  • Create card

    read back

    trello-create-card

    Create one card at the top or bottom of a list, with a name and optionally a description, a due date and labels. Returns the card with its id.

  • Update card

    read back

    trello-update-card

    Update a card's name, description, due date or due-complete flag. Pass at least one; fields you leave out stay as they are. Returns the card.

  • Move card

    read back

    trello-move-card

    Move a card to another list, on the same board or, with board_id, on another board. Optionally put it at the top or bottom. Returns the card.

  • Archive card

    read back

    trello-archive-card

    Archive (close) a card. It leaves the board's lists and can be restored with restore-card. Returns the card.

  • Restore card

    read back

    trello-restore-card

    Restore an archived card to its list. Returns the card.

  • Add comment

    read back

    trello-add-comment

    Add one comment to a card. Board members see it, and a member it @mentions is notified. Returns the comment action with its id.

  • Add label

    read back

    trello-add-label

    Put one of the board's labels on a card. Labels already on the card stay.

  • Remove label

    read back

    trello-remove-label

    Take one label off a card. The label stays on the board.

  • Delete card

    acknowledged

    trello-delete-card

    Delete a card for good, with its comments and checklists. It cannot be restored; use archive-card to keep it.

Reads

  • List boards

    trello-list-boards

    List the boards the connected Trello account is a member of. Returns each board's id, name, closed flag, url, workspace id (idOrganization) and starred flag. Filter by open, closed, starred or all; Trello's default is all. Trello does not page this list.

  • Get board

    trello-get-board

    Get one board: its id, name, description, closed flag, url, workspace id, last activity date and the names of its color labels (labelNames). Use list-lists and list-labels for its lists and labels.

  • List lists

    trello-list-lists

    List the lists (columns) on a board, in board order. Returns each list's id, name, closed flag, position and board id. Open lists by default; pass filter closed or all for archived ones. Trello does not page this list.

  • List labels

    trello-list-labels

    List the labels defined on a board. Returns up to 50, each with id, name, color and board id. Use a label id with add-label or remove-label.

  • List board cards

    trello-list-board-cards

    List the open cards on a board, 50 a page, each with id, name, list id, board id, closed flag, due date, due complete, label ids, member ids, short url, last activity and position. The description is left out; read it with get-card. For the next page, pass the id of the last card as before.

  • List list cards

    trello-list-list-cards

    List the open cards in one list, 50 a page, each with id, name, list id, board id, closed flag, due date, due complete, label ids, member ids, short url, last activity and position. The description is left out; read it with get-card. For the next page, pass the id of the last card as before.

  • Search cards

    trello-search-cards

    Search cards by text in their name, description and comments, across the boards the account can reach or on one board. Returns up to 20 cards a page under cards, each with id, name, list id, board id, closed flag, due date, due complete, label ids, member ids, short url, last activity and position. The description is left out; read it with get-card. Pass page 1, 2 and so on for later pages. Set partial to true to match the start of words.

  • Get card

    trello-get-card

    Get one card: its name, description, list, board, closed flag, due and start dates, labels (id, name, color), members, badges (comment and checklist counts) and urls.

  • List card comments

    trello-list-card-comments

    List the comments on a card, newest at the top, 50 a page. Each is an action of type commentCard with its id, date, author (memberCreator) and the text under data.text. Pass page 1, 2 and so on for later pages; Trello serves up to page 19.

How do users connect? Each one brings their own Trello.

  1. 1.Call for the userYour server invokes the action for the signed-in user. Without a Trello connection, the SDK throws EndUserNotConnectedError with a connect link.
  2. 2.The user pastes a keyThe link opens a form that shows where in Trello's settings to create the key. The link lasts 10 minutes and works once.
  3. 3.Anlyon checks itThe key is checked with Trello before it is kept, and bound to api.trello.com. It is never shown back.
  4. 4.Your server confirmsYour server confirms the connection for the user who is signed in, and the call goes through.

Guardrails. Suggested limits and approvals, for you to review.

Suggested limits

  • 100 cards created a day
  • 200 cards updated a day
  • 300 cards moved a day
  • 100 cards archived a day
  • 50 cards restored a day
  • 200 comments a day
  • 300 labels added a day
  • 300 labels removed a day
  • 20 cards deleted a day

Suggested approvals

  • A person approves deleting a card

What the key must allow

  • An API key from a Power-Up you create, and a token for your account
  • The token acts as you on every board you can reach

Good to know

  • Create the token from an account that is a member of only the boards your agent should work in.
  • A comment or a description is bounded to 4,000 characters, because Trello takes them in the URL.

For your own account

  1. 1.In Trello, create a Power-Up at trello.com/power-ups/admin and generate its API key.
  2. 2.Use the key's Token link to create a token for your account.
  3. 3.In Anlyon, open Actions, then Integrations, choose Trello and paste the key and the token.
  4. 4.Anlyon checks them with Trello before storing them. They become a secret named TRELLO, bound to api.trello.com.

Trello in your code. For one of your users, or for your own account.

Act for one of your users from your server, or connect your company's own Trello with the CLI.

trello.ts
import { Client, EndUserNotConnectedError } from "@anlyonhq/sdk";const anlyon = new Client({ apiKey: process.env.ANLYON_API_KEY! });try {  const { data } = await anlyon    .forUser(session.userId)    .actions.invoke("trello-create-card", {      list_id: "5f8a1b2c3d4e5f6a7b8c9d0e",      name: "Follow up with Acme"    });  return { status: "done", grade: data.grade };} catch (error) {  if (error instanceof EndUserNotConnectedError) {    // The user connects their own Trello, then you call again.    return { status: "connect_required", url: error.connectUrl };  }  throw error;}

Let your agent act for your users, safely.

A few lines of server code, then send a user a connect link. Nothing to host.

$ claude mcp add --transport http anlyon https://api.anlyon.com/mcp