⚖️ Independent project. Not developed, supported, or endorsed by Atlassian Pty Ltd or Trello. "Trello" is a registered trademark of Atlassian. This extension uses Trello's official REST API and only works with the end user's own API key/token.

🇹🇷 Türkçe README için: README.tr.md

MCP for Trello

A VSCode extension that provides a MCP (Model Context Protocol) server for Trello. It connects AI agents like Claude Code, GitHub Copilot, and Cursor to your Trello boards — so you can create cards, move them, label, assign, and search through natural language conversation with your agent.

🤖 Main feature: Manage Trello with AI agents. 🗂️ Bonus: Visual kanban sidebar (optional).

Why this extension?

One of the most annoying things while pair-programming with an AI agent is breaking flow to switch to your browser just to say "save this bug as a note and push it to tomorrow." This extension solves exactly that: the agent talks to Trello from inside VSCode, directly with your boards.

You    → "Open a card in Backlog for the auth bug, label it Bug, assign me, due today"
Agent  → [create_card → add_label_to_card → assign_member → update_card]
       → "Done. Created card 'Auth: token expiration loop'."

Features

🤖 AI Agent Integration (the main feature)

• Embedded MCP server — starts automatically when the extension activates (child process, stdio transport).
• 36 MCP tools — boards, lists, cards, labels, checklists, comments, members, search, bulk operations. Full list below.
• Automatic agent setup — one-click config generation for Claude Code, GitHub Copilot (VSCode native chat), and Cursor. No manual JSON editing.

🗂️ Visual Kanban Sidebar (bonus)

• Kanban view in the VSCode side bar with drag-and-drop card moving.
• Quick-add cards (Ctrl/Cmd+Shift+T):

  Write API documentation @Backlog #docs !2026-05-01
  

• Command palette: list boards, search cards, see your assigned cards, generate board summary, move cards.
• Status bar — count of cards assigned to you + warning for overdue ones.
• Notifications — for upcoming and overdue cards.

🔐 Security

• API key/token in VSCode SecretStorage (OS keychain), no plaintext.
• No telemetry. No data sent to any third-party server.
• Single target: api.trello.com. No requests anywhere else.
• Open source — you can inspect exactly what the code does.

⚠️ AI agent warning: The agent you connect can create, move, delete cards and write comments on your behalf. The extension does not ask for additional confirmation for destructive operations. If this is a critical Trello workspace, try it on a test workspace first.

Installation

From the VSCode Marketplace

VSCode → Extensions → search "MCP for Trello" → Install.

From a .vsix file

VSCode → Extensions → ... menu → Install from VSIX... → select the downloaded .vsix.

From source (development)

git clone https://github.com/ebykdrms/mcp-for-trello.git
cd mcp-for-trello
npm install
npm run build

Open the project in VSCode → press F5 → Extension Development Host starts.

First-time Setup: Step by Step

When you open the extension for the first time, the Trello Setup Wizard opens automatically in the side panel. The wizard walks you through 7 steps:

1. Explains what the extension does and how data flows
2. Opens the Trello Power-Up Admin page
3. Helps you create a Power-Up via the "New" button
4. Walks through the form fields, especially the confusing "Iframe URL" field (with a copy-to-clipboard button)
5. Getting the API Key (which section of the page, which button to click)
6. Getting the Token (where the link is — note: localized Trello UIs may use a translated label, e.g. "Belirteç" in Turkish)
7. Auto-save

As soon as the wizard finishes, the AI Agent Connection Menu opens → asks which agent you want to connect to. You can run it again for additional agents.

Supported AI Agents

Command palette → Trello: Connect to AI Agents to open the menu any time.

Commands

MCP Tool Catalog

36 tools across 9 categories:

• Boards: list_boards, get_board, create_board, get_board_activity
• Lists: get_lists, create_list, archive_list, rename_list
• Cards: get_cards, get_card, create_card, update_card, move_card, archive_card, delete_card
• Labels: get_labels, create_label, add_label_to_card, remove_label_from_card
• Checklists: get_checklists, create_checklist, add_check_item, toggle_check_item, delete_checklist
• Comments: get_comments, add_comment
• Members: get_me, get_board_members, assign_member, unassign_member
• Search: search_trello
• Automation: get_my_cards, get_board_summary, bulk_move_cards, bulk_archive_cards, duplicate_card

Architecture

┌──────────────────────────────────────────┐
│             VSCode Extension              │
│                                          │
│  ┌──────────┐         ┌──────────────┐   │
│  │ Sidebar  │         │  MCP Server  │◄──┼── AI Agents
│  │ Commands │         │ (child proc) │   │  (Claude Code,
│  │ StatusBar│         └───────┬──────┘   │   Copilot, Cursor)
│  └────┬─────┘                 │          │
│       │                       │          │
│       ▼                       ▼          │
│  ┌──────────────────────────────┐        │
│  │     TrelloClient (singleton)  │       │
│  └──────────┬───────────────────┘        │
└─────────────┼────────────────────────────┘
              ▼
         api.trello.com/1/

• TrelloClient singleton — UI and MCP share the same instance. Rate limiting (90 req / 10s) is centrally managed with exponential backoff retry.
• mcp-entry.ts runs as a separate Node process — the VSCode extension host already uses stdin/stdout, so the MCP stdio server cannot run in-process.
• SecretStorage — API key/token are never written to settings.json, they are stored in the OS keychain.

Configuration

VSCode Settings → search "trello":

License

MIT — see LICENSE.