Trello MCP | OAuth 2.1 Trello connector for agents

Tools your project management agent reaches for on Trello MCP, scoped per user.

CALL ANY TOOL

List boards and cards, move cards between lists, post comments, and manage labels and members through Trello's official MCP server.

trellomcp_trello_read_board

Trello read board

Read Trello boards. Supports listing boards the authenticated user is a member of, listing all boards a user can access within a specific workspace (regardless of membership), fetching a single board by ARI or URL, and listing labels on a board. Actions: - "list": paginated boards the authenticated user is a member of, across all workspaces. Use this for "my boards", "boards I'm on". It does NOT include boards the user could access but has not joined: for those, use "list_by_workspace". By default only open (non-archived) boards are returned; pass filter="all" to include archived boards or filter="closed" for only archived ones. Always include each board's url verbatim in the response. Optionally also filtered by visibility (limit defaults to 25, max 100). The open/closed filter is applied server-side (exact), whereas the visibility filter is applied per page: keep paginating via pageInfo.endCursor while pageInfo.hasNextPage is true to find all matches. - "list_by_workspace": paginated boards the user can access within ONE workspace (requires workspaceId), regardless of whether they are a member. Use this when the user names a workspace: "boards in <workspace>", "what's in this workspace". Supports the same open/closed filter, visibility filter, and pagination as "list". Always include each board's url verbatim in the response. - "get": return a single board by ARI or board URL (e.g. https://trello.com/b/<shortLink>/<slug>), including id, objectId, name, closed, shortLink, lastActivityAt, and url. Always include the board url verbatim as the full literal URL: never replace it with a label such as "View on Trello" or hide it behind link text; never omit it. Embeds the first 25 open lists with a listsHasMore flag; for the full set call trelloReadList with action="list_by_board". - "list_labels": paginated labels on a board (requires boardId; limit defaults to 25, max 100); paginate via nextCursor while hasMore is true.

Parameters

Name

Type

Required

Description

action

string

Required

Action to perform: "list" (my boards), "list_by_workspace" (boards in a workspace), "get" (single board), "list_labels" (labels on a board).

boardId

string

Optional

Trello board identifier. Required for "get" and "list_labels"; not allowed for other actions. For action="get", accepts an ARI (e.g. ari:cloud:trello::board/workspace/<workspaceId>/<boardId>) or a Trello board URL (e.g. https://trello.com/b/<shortLink>/<slug>). For all other actions, boardId must be a board ARI: board URLs/short links are not supported.

cursor

string

Optional

Pagination cursor. Only valid for paginated actions ("list", "list_by_workspace", "list_labels").

filter

string

Optional

Filter boards by open/closed state. "open" (default) returns only active (non-archived) boards; "closed" returns only archived boards; "all" returns both. Only valid when action="list" or action="list_by_workspace".

limit

integer

Optional

Maximum results per page. Defaults to 25, max 100. Only valid for paginated actions ("list", "list_by_workspace", "list_labels").

visibility

string

Optional

Filter boards by visibility. Only valid when action="list" or action="list_by_workspace".

workspaceId

string

Optional

Trello workspace identifier. Required for action="list_by_workspace"; not allowed for other actions. Accepts an ARI (e.g. ari:cloud:trello::workspace/<workspaceId>).

trellomcp_trello_read_card

Trello read card

Fetch a Trello card's full details, or list cards across a board or list to surface open work items. Use this tool when you know the specific board, list, or card you want to inspect. For keyword-based discovery across all boards/cards, use trelloSearch instead. Actions: - "get": fetch a single card by id or card URL (cardIdOrUrl required). Returns core card fields and labels (up to 25; truncation signalled via labelsHasMore). - "list_by_board": fetch all cards for a board grouped by list (boardIdOrUrl required). Response: { lists: [{ id, name, cards: [...] }], hasNextPage, nextCursor }. Each page contains up to 25 lists (configurable via limit); each list contains all its cards. Filter by card state: "open" (default), "archived", or "all". Use cursor/limit to paginate over lists (max 50 lists per page). - "list_by_list": fetch cards in a Trello list (listId required) with cursor-based pagination. Use this when the user asks for cards in a list or all cards from a specific list. Response: { cards: [...], pageInfo: { hasNextPage, endCursor } }. Filter by card state: "open" (default), "archived", or "all". Use cursor/limit to paginate (max 50 cards per page). Due date timezone handling: Card due dates (due.date) are stored as UTC ISO 8601 timestamps. For "today" or date-based due-date requests, first call trelloReadMember (get_me) for prefs.timezone and interpret due dates in the user's local time.

Parameters

Name

Type

Required

Description

action

string

Required

Action to perform: "get" fetches a single card, "list_by_board" fetches cards grouped by list for a board, "list_by_list" fetches cards in a specific list.

boardIdOrUrl

string

Optional

Trello board identifier. Required for "list_by_board". Accepts an ARI (e.g. ari:cloud:trello::board/workspace/<workspaceId>/<boardId>). A Trello board URL is also accepted (e.g. https://trello.com/b/<shortLink>/<slug>).

cardIdOrUrl

string

Optional

Trello card identifier. Required for "get". Accepts an ARI (e.g. ari:cloud:trello::card/workspace/<workspaceId>/<cardId>) or a Trello card URL (e.g. https://trello.com/c/<shortLink>/<slug>).

cursor

string

Optional

Pagination cursor for list actions. Not allowed for "get".

filter

string

Optional

Card state filter for "list_by_board" and "list_by_list". One of: "open" (default), "archived", "all". Not allowed for "get".

limit

integer

Optional

Pagination limit (1-50) for list actions. Not allowed for "get".

listId

string

Optional

Trello list identifier. Required for "list_by_list". Accepts an ARI (e.g. ari:cloud:trello::list/workspace/<workspaceId>/<listId>).

trellomcp_trello_read_checklist

Trello read checklist

trellomcp_trello_read_inbox

Trello read inbox

trellomcp_trello_read_list

List trello read

trellomcp_trello_read_member

Trello read member

trellomcp_trello_read_planner

Trello read planner

Read Trello Planner information for the authenticated user. Supported actions: "get": returns the current member's planner (id, primaryAccountId, primaryCalendarId, primaryCalendar details); "list_events": lists calendar events for a given planner calendar in a time window (plannerCalendarId, providerAccountId, start, end required; limit defaults to 25, max 50; cursor-based pagination supported); "get_event": returns a single calendar event by provider event id (eventId, providerAccountId, plannerCalendarId required). Timezone handling: start and end must be UTC ISO 8601. For relative time queries like "today" or "this week", first use the "get" action to retrieve primaryCalendar.timezone, then convert to UTC before calling "list_events".

Parameters

Name

Type

Required

Description

action

string

Required

Action to perform. "get" takes no additional args and returns the current member's planner. "list_events" requires plannerCalendarId, providerAccountId, start, end (cursor and limit optional). "get_event" requires eventId, providerAccountId, plannerCalendarId.

cursor

string

Optional

Pagination cursor. Only valid for "list_events".

end

string

Optional

Event window end as a UTC ISO 8601 date-time string. Must be after start. For relative queries like "today", first use the "get" action to retrieve primaryCalendar.timezone and convert to UTC. Required for "list_events".

eventId

string

Optional

Provider event ID. Required for "get_event".

limit

integer

Optional

Maximum number of events to return. Defaults to 25, max 50. Only valid for "list_events".

plannerCalendarId

string

Optional

Trello planner calendar identifier. Required for "list_events" and "get_event". Accepts an ARI (e.g. ari:cloud:trello::planner-calendar/<calendarId>).

providerAccountId

string

Optional

Provider account ARI (e.g. Google account ARI like "ari:third-party:google::account/<id>"). Required for "list_events" and "get_event".

start

string

Optional

Event window start as a UTC ISO 8601 date-time string. For relative queries like "today", first use the "get" action to retrieve primaryCalendar.timezone and convert to UTC. Required for "list_events".

trellomcp_trello_read_workspace

Trello read workspace

trellomcp_trello_search

Search trello

Discover Trello boards or cards by keyword across all workspaces. Use this when the user wants to find something by name or content but does not know which board it is on. If the user already knows the board or list they want to browse, use trelloReadCard (list_by_board or list_by_list) instead: it is faster and returns richer grouped results. Supported actions: "search_boards": search for boards by name, always include each board's `url` verbatim in the response; "search_cards": search for cards by name/content. Both support optional workspace scoping and cursor-based pagination. Both actions return open (non-archived) results by default. To search archived items instead, include `is:archived` in the query. "search_cards" additionally supports boardIds scoping and qualifiers: label:, board:, list:, member:, due:, has:. For archived/closed cards, use `is:archived` or `is:closed` (they are equivalent for cards only). For archived boards, use `is:archived` only: boards do not support the `is:closed` alias. Due date timezone handling: Trello due-date search qualifiers use UTC boundaries. For "today" or date-based due-date queries, first call trelloReadMember (get_me) for prefs.timezone and account for the user's local timezone.

Parameters

Name

Type

Required

Description

action

string

Required

The search action to perform: "search_boards" or "search_cards".

query

string

Required

Required free-text query string to search for (min 1 character).

boardIds

array

Optional

Optional list of board ARIs to scope card search results (e.g. ["ari:cloud:trello::board/workspace/<workspaceId>/<boardId>"]). Only valid for "search_cards".

cursor

string

Optional

Pagination cursor from a prior response's nextCursor field.

limit

integer

Optional

Maximum number of results to return (default 10, max 100).

partial

boolean

Optional

Enable partial/prefix matching on names (default false).

workspaceIds

array

Optional

Optional list of workspace ARIs to scope search results (e.g. ["ari:cloud:trello::workspace/<workspaceId>"]). Valid for both "search_boards" and "search_cards".

trellomcp_trello_write_board

Trello write board

trellomcp_trello_write_card

Trello write card

Create, update, move, archive, mark Trello cards done, or manage labels on cards. Supported actions: "create": create a card on a list (listId and name required; desc, due, pos optional); "update": update an existing card (cardId required; at least one of name, desc, due required); "move": move a card to another list, optionally across boards (cardId and listId required, where listId is the destination list; boardId is optional and only needed when moving to a list on a different board; pos is optional and sets the card position in the destination list); "archive": archive a card (cardId required); "mark_done": mark a card as complete (cardId required); "attach_label": attach a label to a card (cardId and labelId required); "detach_label": detach a label from a card (cardId and labelId required).

Parameters

Name

Type

Required

Description

action

string

Required

Action to perform: "create" creates a card; "update" updates card fields; "move" moves a card to another list; "archive" archives a card; "mark_done" marks a card complete; "attach_label" attaches a label to a card; "detach_label" detaches a label from a card.

boardId

string

Optional

Trello board ARI (e.g. "ari:cloud:trello::board/workspace/<workspaceId>/<boardId>"). Only used by "move": pass the destination board ARI when moving a card to a list on a different board. Omit when moving within the same board. Must be paired with listId: boardId on its own is not allowed.

cardId

string

Optional

Trello card ARI: the `id` field returned by trelloReadCard (e.g. "ari:cloud:trello::card/workspace/<workspaceId>/<cardId>"). Do NOT pass a Trello URL or short link; use trelloReadCard first to obtain the ARI. Required for "update", "move", "archive", "mark_done", "attach_label", "detach_label".

desc

string

Optional

Card description. Optional for "create" and "update".

due

string

Optional

Card due date as a UTC ISO 8601 date-time string (e.g. "2026-06-01T17:00:00.000Z"). Optional for "create" and "update".

labelId

string

Optional

Trello label ARI (e.g. "ari:cloud:trello::label/workspace/<workspaceId>/<labelId>"). Required for "attach_label" and "detach_label".

listId

string

Optional

Trello list ARI (e.g. "ari:cloud:trello::list/workspace/<workspaceId>/<listId>"). For "create", this is the list the new card is added to. For "move", this is the destination list the card is moved to. Required for "create" and "move".

name

string

Optional

Card name. Required for "create"; optional for "update".

pos

string

Optional

Card position. Optional for "create" and "move". Use "top", "bottom", or a non-negative number (e.g. 16384).

trellomcp_trello_write_checklist

Trello write checklist

Write Trello checklists and their check items. Actions: "create": add a new checklist to a card by cardId and name, optionally placed at "top", "bottom", or an explicit numeric position. Returns the created checklist as a TrelloChecklist (id, objectId, name, position, checkItems[]). "add_item": append a new check item to an existing checklist by checklistId and text, optionally placed at "top", "bottom", or an explicit numeric position. Returns the created check item (id, name, state, position) using the same normalized shape as trelloReadChecklist. "update_item": update an existing check item by checklistId and itemId; supports renaming (text), toggling completion (checked), and repositioning (pos). Returns the updated check item. "update": rename a checklist (name) and/or change its position on its card (pos) by checklistId. At least one of name or pos must be supplied. Returns the resulting checklist in the same normalized shape as trelloReadChecklist (id, name, position, checkItems[]).

Parameters

Name

Type

Required

Description

action

string

Required

Action to perform. "create" requires cardId and name (pos is optional). "add_item" requires checklistId and text (pos is optional). "update_item" requires checklistId and itemId (text, checked, pos are optional). "update" requires checklistId and at least one of name or pos.

cardId

string

Optional

checked

boolean

Optional

Whether the check item is completed. Optional when action="update_item".

checklistId

string

Optional

Trello checklist identifier. Required when action="add_item", action="update_item", or action="update". Accepts an ARI (e.g. ari:cloud:trello::checklist/workspace/<workspaceId>/<checklistId>).

itemId

string

Optional

Trello check item identifier. Required when action="update_item". Accepts an ARI (e.g. ari:cloud:trello::check-item/workspace/<workspaceId>/<itemId>).

name

string

Optional

Name of the checklist. Required when action="create". Optional for action="update" (renames the checklist).

pos

string

Optional

Position of the new checklist on the card (action="create"), the initial position of the new check item within the checklist (action="add_item"), an existing check item (action="update_item"), or an existing checklist on its card (action="update"). "top" or "bottom" places it relative to existing items; a number sets an explicit absolute position.

text

string

Optional

Text (name) of the check item. Required when action="add_item"; optional rename when action="update_item".

trellomcp_trello_write_inbox

Trello write inbox

trellomcp_trello_write_list

List trello write

trellomcp_trello_write_planner

Trello write planner

Build your Agent

Drop the toolkit in, point it at the user, and your project management agent can use Trello from the first run.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Trello MCP tools, scoped to the signed-in user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["trellomcp"], toolNames: [
    "trellomcp_trello_read_board",
    "trellomcp_trello_read_card",
    "trellomcp_trello_read_checklist"
  ] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Which cards in the launch board are still unassigned?" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Trello MCP tools, scoped to the signed-in user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["trellomcp"], toolNames: [
    "trellomcp_trello_read_board",
    "trellomcp_trello_read_card",
    "trellomcp_trello_read_checklist"
  ] },
  pageSize: 100,
});

const openai = new OpenAI();
const res = await openai.responses.create({
  model: "gpt-5",
  tools: tools.map((t) => t.openai),
  input: "Which cards in the launch board are still unassigned?",
});

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Trello MCP tools, scoped to the signed-in user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["trellomcp"], toolNames: [
    "trellomcp_trello_read_board",
    "trellomcp_trello_read_card",
    "trellomcp_trello_read_checklist"
  ] },
  pageSize: 100,
});

const anthropic = new Anthropic();
const msg = await anthropic.messages.create({
  model: "claude-opus-4-6",
  max_tokens: 1024,
  tools: tools.map((t) => t.anthropic),
  messages: [{ role: "user", content: "Which cards in the launch board are still unassigned?" }],
});

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Trello MCP tools, scoped to the signed-in user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["trellomcp"], toolNames: [
    "trellomcp_trello_read_board",
    "trellomcp_trello_read_card",
    "trellomcp_trello_read_checklist"
  ] },
  pageSize: 100,
});

const agent = new Agent({
  name: "trellomcp_agent",
  model: "gemini-2.5-pro",
  instruction: "Act as the project management agent for the signed-in user.",
  tools,
});
await agent.run("Which cards in the launch board are still unassigned?");

Try these prompts

Paste any prompt into your agent to start using Trello.

Board hygiene

Copy the prompt

Copied

Which cards on the launch board have no assignee?

Copy the prompt

Copied

List cards with a due date in the past.

Copy the prompt

Copied

Show every card sitting in Review for more than a week.

Planning

Copy the prompt

Copied

Create a card for the auth migration in the Ready for dev list.

Copy the prompt

Copied

Move the billing bug card to In progress and assign it to me.

Copy the prompt

Copied

Add a checklist to the release card with the four deploy steps.

Reporting

Copy the prompt

Copied

Summarize what moved to Done on the launch board this week.

Copy the prompt

Copied

Count open cards per list on the roadmap board.

Copy the prompt

Copied

Which labels are used most across my boards?

SEE HOW AUTH WORKS

Users authorize Trello once. Their credentials stay vaulted, every call is checked, and every action is logged.

Authorize

Your user connects

Trello MCP

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Trello MCP

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Trello MCP

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Trello MCP

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

Same per-user auth pattern across other agents and MCP connectors. Working code, live demos, fork what fits.

Engineering Teams

Engineering standup agent

Pulls commits from GitHub and GitLab, tracks issue movement in Jira, and posts a per-engineer standup brief to Slack. Each engineer's activity is read on their own delegated OAuth.

Engineering Teams

DevOps assistant agent

Polls GitHub for failing checks and stale PRs, opens Linear issues for the ones that need work, and posts a daily digest to Slack. It acts as the engineer, not a shared service account.

Engineering Teams

Slack triage

Polls Slack for new messages, classifies bugs and support requests with a LangGraph router, files GitHub issues or Zendesk tickets, and confirms in the thread.

People Ops and HR teams

Performance review collector

Collects review feedback from Airtable and Google Forms scoped to each manager's direct reports, writes per-employee summaries to Notion, and DMs the manager a Slack digest.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential so attribution, audit, and scope stay accurate.

// shared token
audit → bot_service_account
user_filter → broken

// scalekit
audit → user_abc
scope → enforced ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Trello today. Others tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Trello as the user or as a shared key?

As the user. Each member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.

Where is the Trello oauth 2.1 credential stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent is allowed to do in Trello?

Yes. Pass a tool name filter to listScopedTools so the project management agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Trello.

What happens when a user revokes Trello access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Can the agent reach boards the user was never added to?

No. Trello MCP resolves the authorizing user's membership, so only boards that user belongs to are visible. Private boards in other workspaces stay inaccessible, and board-level permissions apply on every agent call.

On this page

Tool and actions Framework Compatibility Starter Prompt Auth Lifecycle Try Other Agents Why Scalekit