trello-apiTrello 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, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Install via ClawdBot CLI:
clawdbot install byungkyu/trello-apiAccess 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))
EOFhttps://gateway.maton.ai/trello/{native-api-path}Replace {native-api-path} with the actual Trello API endpoint path. The gateway proxies requests to api.trello.com and automatically injects your OAuth token.
All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEYEnvironment Variable: Set your API key as MATON_API_KEY:
export MATON_API_KEY="YOUR_API_KEY"Manage your Trello OAuth connections at https://ctrl.maton.ai.
python <<'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))
EOFpython <<'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))
EOFpython <<'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))
EOFResponse:
{
"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 url in a browser to complete OAuth authorization.
python <<'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))
EOFIf you have multiple Trello connections, specify which one to use with the Maton-Connection header:
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"]}')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOFIf omitted, the gateway uses the default (oldest) active connection.
GET /trello/1/members/meGET /trello/1/members/me/boardsQuery parameters:
filter - Filter boards: all, open, closed, members, organization, starredfields - Comma-separated fields to includeGET /trello/1/boards/{id}Query parameters:
fields - Comma-separated fieldslists - Include lists: all, open, closed, nonecards - Include cards: all, open, closed, nonemembers - Include members: all, noneExample:
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))
EOFPOST /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}/listsQuery parameters:
filter - Filter: all, open, closed, noneGET /trello/1/boards/{id}/cardsGET /trello/1/boards/{id}/membersGET /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}/cardsPOST /trello/1/lists/{id}/moveAllCards
Content-Type: application/json
{
"idBoard": "BOARD_ID",
"idList": "TARGET_LIST_ID"
}GET /trello/1/cards/{id}Query parameters:
fields - Comma-separated fieldsmembers - Include members (true/false)checklists - Include checklists: all, noneattachments - Include attachments (true/false)POST /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}/labelsPOST /trello/1/labels
Content-Type: application/json
{
"name": "High Priority",
"color": "red",
"idBoard": "BOARD_ID"
}Colors: yellow, purple, blue, red, green, orange, black, sky, pink, lime, null (no color)
PUT /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,boardsQuery parameters:
query - Search query (required)modelTypes - Comma-separated: actions, boards, cards, members, organizationsboard_fields - Fields to return for boardscard_fields - Fields to return for cardscards_limit - Max cards to return (1-1000)const 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 requests
headers = {'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'
}
)me to reference the authenticated userpos can be top, bottom, or a positive numberfields parameter to limit returned data and improve performancefilter=closedcurl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsingjq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.| 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_KEY environment variable is set:echo $MATON_API_KEYpython <<'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))
EOFtrello. For example:https://gateway.maton.ai/trello/1/members/me/boardshttps://gateway.maton.ai/1/members/me/boardsGenerated Mar 1, 2026
Software teams use this skill to manage agile boards, track sprint tasks, and coordinate releases. It automates creating cards for user stories, moving them across lists as status changes, and assigning members, streamlining development workflows.
Marketing and content teams leverage the skill to organize editorial calendars, assign articles to writers, and track publication stages. It helps schedule posts, manage deadlines, and collaborate on content ideas across distributed teams.
Event planners use Trello to plan conferences or weddings by creating boards for tasks like venue booking, vendor management, and guest lists. The skill automates updates, sends reminders, and syncs details across team members.
Support teams integrate this skill to manage customer inquiries as cards, categorize them by priority, and assign agents. It enables real-time updates, escalations, and reporting on resolution times, improving service efficiency.
Product managers utilize the skill to maintain roadmaps, prioritize features, and gather feedback. It automates creating cards for new ideas, linking them to boards, and tracking progress through development cycles.
Companies offer this skill as part of a larger SaaS platform that integrates Trello with other tools like Slack or Jira. They charge subscription fees based on usage tiers, providing value through streamlined workflows and analytics.
Consultants use the skill to build custom Trello automations for clients, such as automated reporting or workflow triggers. Revenue comes from project-based fees or retainer models for ongoing support and optimization.
Developers create a freemium tool that uses this skill for basic Trello management, with advanced features like AI-powered insights or bulk operations behind a paywall. Revenue is generated through premium upgrades and enterprise licenses.
💬 Integration Tip
Use the Maton-Connection header to manage multiple Trello accounts and ensure the MATON_API_KEY is securely stored in environment variables for authentication.
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
Connect to 100+ APIs (Google Workspace, Microsoft 365, GitHub, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth. Use this skill when users want to...
Build, debug, and deploy websites using HTML, CSS, JavaScript, and modern frameworks following production best practices.
YouTube Data API integration with managed OAuth. Search videos, manage playlists, access channel data, and interact with comments. Use this skill when users want to interact with YouTube. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Scaffold, test, document, and debug REST and GraphQL APIs. Use when the user needs to create API endpoints, write integration tests, generate OpenAPI specs, test with curl, mock APIs, or troubleshoot HTTP issues.
Search for jobs across LinkedIn, Indeed, Glassdoor, ZipRecruiter, Google Jobs, Bayt, Naukri, and BDJobs using the JobSpy MCP server.