What It Does
You can manage boards, lists, cards, checklists, labels, and members — covering the full lifecycle of Trello project management. All requests are proxied through `gateway.maton.ai`, which automatically injects your OAuth credentials.
This skill provides full access to the Trello API through Maton's managed OAuth gateway, so your AI agent can read and write Trello data without you ever handling OAuth tokens directly.
Key Features
- Managed OAuth Authentication — All Trello OAuth tokens are handled by the Maton gateway — you only need a single `MATON_API_KEY`. Connect and manage multiple Trello accounts via `ctrl.maton.ai` without touching OAuth flows directly.
- Full Board, List & Card Management — Create, read, update, and delete boards, lists, and cards. Move cards between lists, set due dates, attach members and labels, and add comments — covering the complete Trello card lifecycle.
- Checklists & Checklist Items — Create checklists on cards, add individual checklist items, mark items complete, and delete checklists — enabling fine-grained subtask tracking within Trello cards.
- Label Management — Create, update, and delete labels on boards with support for all Trello label colors (`red`, `green`, `blue`, `yellow`, `purple`, `orange`, and more). Assign and remove labels on individual cards.
- Cross-Board Search — Use Trello's search endpoint to query across cards, boards, members, and organizations in one request. Supports filtering by model type and limiting result counts.
- Multiple Connection Support — If you manage multiple Trello accounts, use the `Maton-Connection` header to target a specific OAuth connection by ID. The gateway defaults to the oldest active connection when none is specified.
Requirements
At least one active connection must exist before making Trello API calls.
- **Maton API Key** *(required)* — Authenticates all requests to the Maton gateway. Obtain your key at [maton.ai/settings](https://maton.ai/settings). - **Trello OAuth Connection** *(required)* — A connected Trello account managed via [ctrl.maton.ai](https://ctrl.maton.ai).
Use Cases
- Automated task creation from external triggers — When a bug is filed in another system or a form is submitted, an AI agent uses this skill to automatically create a Trello card in the appropriate list, set a due date, assign a member, and apply a priority label.
- Daily standup or project status reports — An agent queries all open cards across relevant boards each morning, groups them by list (e.g. To Do, In Progress, Done), and generates a summary report — without anyone manually exporting from Trello.
- Kanban board housekeeping — An agent periodically scans for overdue cards, moves stale items to an 'Overdue' list, adds a comment noting the delay, and removes outdated labels — keeping the board clean without manual effort.
- Onboarding workflow automation — When a new team member joins, an agent creates a dedicated onboarding board, populates it with templated lists and checklist cards, and assigns the new member — all triggered from a single command.