TrelloAI
This server provides full Trello board management via the Model Context Protocol (MCP), enabling AI agents (e.g., Cursor AI) to read and manipulate Trello boards, lists, and cards programmatically using natural language commands.
Read / Inspection:
List all boards — retrieve all open Trello boards for the authenticated user
Get board overview — fetch a complete snapshot including lists, cards, due dates, and links
List lists — enumerate all lists within a specific board
List cards — retrieve cards from a board or specific list, with open/closed/all filtering
Get card details — fetch full card info including description, comments, checklists, and members
Get board activity — view recent actions (creations, moves, comments) on a board
Get labels — list all available labels on a board
Search — search cards by text within a specific board
Write / Modification:
Create card — create a new card with title, description, due date, and labels
Update card — modify a card's name, description, due date, list, or completion status
Move card — move a card from one list to another
Add comment — post a comment on a card
Archive card — archive (close) a card
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TrelloAI Summarize my current tasks on the board"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TrelloAI
Integrazione Trello + Cursor AI tramite Model Context Protocol (MCP), più bot Telegram iManager (Octorate, pulizie, turni). Le regole operative vivono in rules/ e si editano anche dalla UI Admin.
Setup rapido
1. Credenziali Trello
Trello ora richiede un Power-Up per generare le chiavi API (la vecchia pagina trello.com/app-key reindirizza al nuovo portale).
Clicca Nuova app e crea un Power-Up (es. "TrelloAI")
Per l'URL connettore Iframe puoi usare un placeholder HTTPS qualsiasi (es.
https://example.com) — non serve per l'integrazione MCP, serve solo a Trello per creare l'app
Apri il Power-Up → tab Chiave API → Genera una nuova chiave API
Copia la API Key
Clicca il link Token accanto alla chiave → Consenti → copia il Token
2. Configura l'ambiente
cp .env.example .envModifica .env:
TRELLO_API_KEY=la_tua_api_key
TRELLO_TOKEN=il_tuo_token
TRELLO_DEFAULT_BOARD_ID=id_della_board # opzionalePer trovare l'ID board: apri la board su Trello, l'URL contiene /b/SHORTLINK/BOARD_ID — usa BOARD_ID.
3. Installa dipendenze
npm install4. Attiva MCP in Cursor
Il file .cursor/mcp.json è già configurato. Riavvia Cursor o ricarica la finestra (Developer: Reload Window).
Verifica in Cursor Settings → MCP che il server trello risulti connesso.
Related MCP server: Trello MCP Server
Uso
Prompt MCP integrati
Nella chat Cursor, puoi invocare i prompt del server:
gestisci-trello— l'AI leggerules/, analizza la board e gestisce i taskstato-trello— solo riepilogo, senza modifiche
Esempi di richieste
Fammi un riepilogo dei task in corsoSposta in "Fatto" i task completati in reviewCrea un task "Preparare demo" nel Backlog con scadenza venerdìQuali task scadono questa settimana?Personalizza le regole
Modifica i file in rules/ (o usa la UI Admin) per Manutenzioni, Customer care, Pulizie, Interazione clienti. Config strutture/pesi/board in config/.
Tool disponibili
Tool | Descrizione |
| Elenca le board |
| Panoramica completa |
| Card per board/lista |
| Dettaglio card |
| Crea task |
| Aggiorna card |
| Sposta tra liste |
| Aggiunge commento |
| Archivia card |
| Cerca per testo |
| Attività recente |
| Etichette board |
Struttura progetto
trelloAI/
├── .cursor/
│ ├── mcp.json # Config MCP per Cursor
│ └── skills/trello/ # Skill agente
├── rules/ # Policy iManager per area
├── config/ # Strutture, pesi turni, board
├── src/
│ ├── server.js # Server MCP
│ ├── telegram-bot.js # Bot + HTTP admin
│ └── …
├── .env.example
└── README.mdUso da cellulare (Telegram su Scaleway)
Il bot @manager_888_bot (iManager) gira su Scaleway. In gruppo rispondi solo se taggato @manager_888_bot (il nome visualizzato non basta) oppure in reply a un suo messaggio. In privato risponde sempre.
Programmi in locale; sync immediato senza GitHub.
npm run ship:watchPoi testi su Telegram. Commit/push su GitHub solo quando la versione è ok.
Server attuale: 151.115.166.171 (Milano) → https://151-115-166-171.sslip.io
Dettagli: deploy/README.md
UI Admin (config iManager)
Imposta
ADMIN_TOKEN=...nel.envdel server (npm run ship:env)Modifica regole markdown per area, strutture Octorate, pesi turni, board Trello
I secret (API key) restano solo in
.env— la UI mostra solo lo stato
Aree: Manutenzioni · Customer care · Pulizie · Interazione clienti (stub AIBridge).
OAuth Octorate (una tantum)
In Octorate → Settings → Advanced → API aggiungi il redirect:
https://151-115-166-171.sslip.io/oauth/callbackApri https://151-115-166-171.sslip.io/oauth/login e autorizza
Refresh token Octorate
Se il bot dice che Octorate non risponde / token scaduto:
Admin UI → Integrazioni → Rinnova token (usa il refresh senza browser)
Se fallisce → Ricollega (login OAuth) oppure apri
/oauth/loginIn locale:
npm run octorate-refreshe, per aggiornare Scaleway:npm run octorate-refresh -- --ship
Il Super Manager, in caso di 401, prova già un refresh forzato e riconnette MCP.
Troubleshooting
Server MCP non connesso: verifica che
npm installsia stato eseguito e che.envesista401 Unauthorized: controlla API key e token
Board non trovata: verifica
TRELLO_DEFAULT_BOARD_IDo passa l'ID esplicitamenteOctorate No identity: apri
/oauth/loginsul server dopo aver autorizzato il redirect in Octorate
Available Tools
13 toolstrello_add_commentC
Aggiunge un commento a una card
Inputs: text (required), cardId (required).
trello_archive_cardC
Archivia (chiude) una card
Inputs: cardId (required).
trello_create_cardB
Crea una nuova card in una lista
Inputs: name (required), idList (required), due, desc, +1 more.
trello_get_board_activityARead-only
Attività recente su una board (creazioni, spostamenti, commenti)
Inputs: boardId (required), limit.
trello_get_board_overviewARead-only
Panoramica completa di una board: liste, card, scadenze e link
Inputs: boardId.
trello_get_cardARead-only
Dettaglio completo di una card: descrizione, commenti, checklist, membri
Inputs: cardId (required).
trello_get_labelsBRead-only
Elenca le etichette disponibili su una board
Inputs: boardId (required).
trello_list_boardsARead-only
Elenca tutte le board Trello aperte dell'utente
Inputs: no named parameters.
trello_list_cardsBRead-only
Elenca le card di una board o di una lista
Inputs: filter, listId, boardId.
trello_list_listsARead-only
Elenca le liste di una board Trello
Inputs: boardId (required).
trello_move_cardB
Sposta una card in un'altra lista
Inputs: cardId (required), idList (required).
trello_searchARead-only
Cerca card per testo all'interno di una board
Inputs: query (required), boardId (required).
trello_update_cardC
Aggiorna una card esistente (nome, descrizione, scadenza, lista)
Inputs: cardId (required), due, desc, name, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct Trello resource (board, list, card, label, activity) with specific actions, making them clearly distinguishable without overlap.
All tools use the 'trello_' prefix followed by a consistent verb_noun pattern (e.g., list_boards, create_card, get_card), ensuring predictability.
With 13 tools, the server provides a well-scoped set for Trello operations, covering essential CRUD and query actions without being excessive or sparse.
The tool set covers the full lifecycle for cards (create, read, update, move, archive, search, comment) and provides board/list overviews, labels, and activity—missing only rare operations like creating lists or deleting, which are non-critical.
Maintenance
Related MCP Connectors
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
Unofficial community ClickUp MCP via personal API token. Not affiliated with ClickUp.
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
Shared memory for connected AI tools. Projects, rules and skills over MCP. OAuth or API key.
Related MCP Servers
- AlicenseDqualityCmaintenanceAn enhanced Model Context Protocol server providing comprehensive integration between Trello and Cursor AI with 40+ tools covering multiple Trello API categories for complete project management.3211MIT
- AlicenseBqualityDmaintenanceConnects Trello with AI assistants to manage boards, lists, cards, and comments via natural language.117MIT
- AlicenseNot gradedqualityBmaintenanceEnables human-in-the-loop AI development where Trello tickets drive analysis, implementation, commits, and board sync in Cursor.MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Trello boards, lists, and cards via MCP clients like Claude, allowing read, create, update, and search operations through natural language.96 npmMIT