Trello API integration with managed OAuth. Manage boards, lists, cards, members, and labels. Use this skill when users want to interact with Trello for project management. For other third party apps,
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Access the Trello API with managed OAuth authentication. Manage boards, lists, cards, checklists, labels, and members for project and task management.
# Get boards for current user python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/trello/1/members/me/boards') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/trello/{native-api-path}
Replace
{native-api-path}api.trello.comAll requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as
MATON_API_KEYexport MATON_API_KEY="YOUR_API_KEY"
Manage your Trello OAuth connections at
https://ctrl.maton.aipython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=trello&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'trello'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Response:
{ "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=...", "app": "trello", "metadata": {} } }
Open the returned
urlpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple Trello connections, specify which one to use with the
Maton-Connectionpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/trello/1/members/me/boards') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If omitted, the gateway uses the default (oldest) active connection.
GET /trello/1/members/me
GET /trello/1/members/me/boards
Query parameters:
filterallopenclosedmembersorganizationstarredfieldsGET /trello/1/boards/{id}
Query parameters:
fieldslistsallopenclosednonecardsallopenclosednonemembersallnoneExample:
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/trello/1/boards/BOARD_ID?lists=open&cards=open') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
POST /trello/1/boards Content-Type: application/json{ "name": "Project Alpha", "desc": "Main project board", "defaultLists": false, "prefs_permissionLevel": "private" }
PUT /trello/1/boards/{id} Content-Type: application/json{ "name": "Project Alpha - Updated", "desc": "Updated description" }
DELETE /trello/1/boards/{id}
GET /trello/1/boards/{id}/lists
Query parameters:
filterallopenclosednoneGET /trello/1/boards/{id}/cards
GET /trello/1/boards/{id}/members
GET /trello/1/lists/{id}
POST /trello/1/lists Content-Type: application/json{ "name": "To Do", "idBoard": "BOARD_ID", "pos": "top" }
PUT /trello/1/lists/{id} Content-Type: application/json{ "name": "In Progress" }
PUT /trello/1/lists/{id}/closed Content-Type: application/json{ "value": true }
GET /trello/1/lists/{id}/cards
POST /trello/1/lists/{id}/moveAllCards Content-Type: application/json{ "idBoard": "BOARD_ID", "idList": "TARGET_LIST_ID" }
GET /trello/1/cards/{id}
Query parameters:
fieldsmemberschecklistsallnoneattachmentsPOST /trello/1/cards Content-Type: application/json{ "name": "Implement feature X", "desc": "Description of the task", "idList": "LIST_ID", "pos": "bottom", "due": "2025-03-30T12:00:00.000Z", "idMembers": ["MEMBER_ID"], "idLabels": ["LABEL_ID"] }
PUT /trello/1/cards/{id} Content-Type: application/json{ "name": "Updated card name", "desc": "Updated description", "due": "2025-04-15T12:00:00.000Z", "dueComplete": false }
PUT /trello/1/cards/{id} Content-Type: application/json{ "idList": "NEW_LIST_ID", "pos": "top" }
DELETE /trello/1/cards/{id}
POST /trello/1/cards/{id}/actions/comments Content-Type: application/json{ "text": "This is a comment" }
POST /trello/1/cards/{id}/idMembers Content-Type: application/json{ "value": "MEMBER_ID" }
DELETE /trello/1/cards/{id}/idMembers/{idMember}
POST /trello/1/cards/{id}/idLabels Content-Type: application/json{ "value": "LABEL_ID" }
GET /trello/1/checklists/{id}
POST /trello/1/checklists Content-Type: application/json{ "idCard": "CARD_ID", "name": "Task Checklist" }
POST /trello/1/checklists/{id}/checkItems Content-Type: application/json{ "name": "Subtask 1", "pos": "bottom", "checked": false }
PUT /trello/1/cards/{cardId}/checkItem/{checkItemId} Content-Type: application/json{ "state": "complete" }
DELETE /trello/1/checklists/{id}
GET /trello/1/boards/{id}/labels
POST /trello/1/labels Content-Type: application/json{ "name": "High Priority", "color": "red", "idBoard": "BOARD_ID" }
Colors:
yellowpurpleblueredgreenorangeblackskypinklimenullPUT /trello/1/labels/{id} Content-Type: application/json{ "name": "Critical", "color": "red" }
DELETE /trello/1/labels/{id}
GET /trello/1/search?query=keyword&modelTypes=cards,boards
Query parameters:
querymodelTypesactionsboardscardsmembersorganizationsboard_fieldscard_fieldscards_limitconst headers = { 'Authorization': `Bearer ${process.env.MATON_API_KEY}` };// Get boards const boards = await fetch( 'https://gateway.maton.ai/trello/1/members/me/boards', { headers } ).then(r => r.json());
// Create card await fetch( 'https://gateway.maton.ai/trello/1/cards', { method: 'POST', headers: { ...headers, 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'New Task', idList: 'LIST_ID', desc: 'Task description' }) } );
import os import requestsheaders = {'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}
Get boards
boards = requests.get( 'https://gateway.maton.ai/trello/1/members/me/boards', headers=headers ).json()
Create card
response = requests.post( 'https://gateway.maton.ai/trello/1/cards', headers=headers, json={ 'name': 'New Task', 'idList': 'LIST_ID', 'desc': 'Task description' } )
mepostopbottomfieldsfilter=closedcurl -gfields[]sort[]records[]jq$MATON_API_KEY| Status | Meaning |
|---|---|
| 400 | Missing Trello connection or invalid request |
| 401 | Invalid or missing Maton API key |
| 404 | Board, list, or card not found |
| 429 | Rate limited (10 req/sec per account) |
| 4xx/5xx | Passthrough error from Trello API |
MATON_API_KEYecho $MATON_API_KEY
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
trellohttps://gateway.maton.ai/trello/1/members/me/boardshttps://gateway.maton.ai/1/members/me/boardsNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.