Trello

Overview

The Trello integration connects your Trello boards to Monday Morning. Its primary job is the one-time import — bring an existing board’s lanes and cards in, and from then on the project runs on Monday Morning — with ongoing sync tools for teams that keep both sides alive during a transition.

Tool Group

All three Trello tools belong to the opt-in trello tool group. They are not listed in the agent’s tool catalog until you opt in via the Monday Morning server entry in .mcp.json:

"env": { "MM_TOOL_GROUPS": "trello" }

The tools still dispatch by name even when not listed — opting in only makes them visible in tools/list.

Prerequisites

• A Trello account
• A Trello API Key and API Token from the Power-Up admin page
• Access to the boards you want to import or sync

Setup

Step 1: Get Your API Key

1. Go to trello.com/power-ups/admin
2. Click New to create a Power-Up (name it anything, leave the iframe URL blank)
3. Open it and copy the key from its API Key tab

Step 2: Generate an API Token

1. On the same API Key tab, click the linked Token, then Allow
2. Trello shows your token on the next page — copy it

Step 3: Configure in Monday Morning

In the desktop app, add the API Key and API Token in the Trello plugin’s settings (Settings → Plugins). A Test control verifies the credentials against Trello. The desktop app writes them to the bridge file .mm/integrations/trello.json so the MCP server can use them too.

Without the desktop app, credentials fall back to environment variables:

export TRELLO_API_KEY="your_api_key_here"
export TRELLO_TOKEN="your_api_token_here"

The bridge file is checked first; the environment variables are the fallback.

Step 4: Link a Board and Map Lists

In Settings → Integrations → Trello — an inline expandable row — link a board and map its lists to task stages. The board picker and list mapping live directly in the settings row; you can change the board later from the same place. Note that the connect row reports “Not connected” until credentials exist in the Plugins section.

There is also a one-time Import from Trello action in Settings → Plugins for the migration case.

Step 5: Verify the Connection

Ask your agent to import your board:

Import my Trello board into this project

The agent will call mm_import_trello. If configured correctly, cards from your linked board appear as Monday Morning tasks and issues.

Available Tools

Tool	Description
mm_import_trello	Import Trello cards as tasks and issues. Maps cards from configured board lists into spec tasks, and bug-list cards into .mm/issues/.
mm_export_trello	Export spec progress to linked Trello cards — posts progress comments and updates card descriptions with task completion status.
mm_sync_trello	Full bidirectional sync. Detects card list changes and updates task statuses, archives specs when their linked cards are archived, and marks issues orphaned when their cards are deleted.

Common Workflows

Import a Trello board into Monday Morning

Import all cards from my linked Trello board

The agent calls mm_import_trello, pulling cards from the linked board into .mm/ using your list-to-stage mapping (overridable per call with list_mapping).

Push spec progress back to Trello

Update the Trello cards for the 2026-03-15-dark-mode spec with current progress

The agent calls mm_export_trello with the spec folder, posting progress comments on the linked cards.

Keep both sides reconciled

Sync this project with Trello

The agent calls mm_sync_trello to reconcile list moves, archivals, and deletions between Trello and Monday Morning.

Troubleshooting

“Unauthorized” error Your API key or token is invalid. Regenerate them at trello.com/power-ups/admin.

“Board not found” error Ensure you have access to the board and that it is linked in Settings → Integrations → Trello. Private boards require the token to be generated by a board member.

Cards not syncing Check that both credentials are present — either in the Trello plugin settings (bridge file .mm/integrations/trello.json) or as TRELLO_API_KEY and TRELLO_TOKEN. Trello requires both for authenticated requests.

The agent says it can’t see the Trello tools The trello group is not opted in. Add "MM_TOOL_GROUPS": "trello" to the server’s env in .mcp.json — or ask the agent to call the tool by its exact name; delisted tools still dispatch.

Cards land in unexpected states Trello lists map to task stages via the list mapping in Settings → Integrations → Trello. Review the mapping there, or pass an explicit list_mapping to mm_import_trello.