Agent skill

Trello API

by CraftOS-dev in CraftOS-dev/CraftBot

Trello API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

MITAuto-check passedBackend & APIs

Install Trello API

skills CLI
$ npx skills add CraftOS-dev/CraftBot --skill trello-api -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install CraftOS-dev/CraftBot trello-api --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/trello-api .claude/skills/trello-api && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
trello-api
GitHub stars
392
Token cost
~3.2k tokens
SKILL.md length
558 words
Files
4
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

Trello API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

  • Works in 3 steps: Sign in or create an account at maton.ai → Go to maton.ai/settings → Copy your API key
  • Users want to interact with Trello for project management
  • SKILL.md covers Quick Start, Base URL, Authentication and Connection Management, plus 5 more sections
  • Calls python and curl; reaches gateway.maton.ai and ctrl.maton.ai; needs MATON_API_KEY

What it does

Trello API is an agent skill from CraftOS-dev/CraftBot. 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, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `.clawhub/origin.json` and `_meta.json`). Compatibility notes: Requires network access and valid Maton API key

It sits in Backend & APIs, covering Microservices, Third-party API integration and Project management. The repository describes itself as: One agent. Every kind of work. The licence is MIT.

When your agent uses it

  • Users want to interact with Trello for project management
  • Tasks that involve Microservices
  • Tasks that involve Third-party API integration

Example prompts

  • “/trello-api”

Requirements

  • Python 3
  • A credential in MATON_API_KEY
  • A credential in YOUR_API_KEY
  • Compatibility (from SKILL.md): Requires network access and valid Maton API key

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Sign in or create an account at maton.ai
  2. Go to maton.ai/settings
  3. Copy your API key

What it can do on your machine

Read from SKILL.md and the folder at commit b50970c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • gateway.maton.ai
    • ctrl.maton.ai
    • connect.maton.ai

    Also links to:

    • developer.atlassian.com
    • maton.ai
    • discord.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MATON_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires network access and valid Maton API key

    From compatibility in the SKILL.md frontmatter.

Context cost

Trello API loads about 3.2k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 558 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 558 words, ~3,227 tokens.

Download SKILL.mdSave it as .claude/skills/trello-api/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
trello-api
description
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, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
compatibility
Requires network access and valid Maton API key
metadata.author
maton
metadata.version
1.0

Trello

Access the Trello API with managed OAuth authentication. Manage boards, lists, cards, checklists, labels, and members for project and task management.

Quick Start

bash
# 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

Base URL

https://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.

Authentication

All requests require the Maton API key in the Authorization header:

Authorization: Bearer $MATON_API_KEY

Environment Variable: Set your API key as MATON_API_KEY:

bash
export MATON_API_KEY="YOUR_API_KEY"
Getting Your API Key
  1. Sign in or create an account at maton.ai
  2. Go to maton.ai/settings
  3. Copy your API key

Connection Management

Manage your Trello OAuth connections at https://ctrl.maton.ai.

List Connections
bash
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))
EOF
Create Connection
bash
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
Get Connection
bash
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:

json
{
  "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.

Delete Connection
bash
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))
EOF
Specifying Connection

If you have multiple Trello connections, specify which one to use with the Maton-Connection header:

bash
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))
EOF

If omitted, the gateway uses the default (oldest) active connection.

API Reference

Members
Get Current Member
bash
GET /trello/1/members/me
Get Member's Boards
bash
GET /trello/1/members/me/boards

Query parameters:

  • filter - Filter boards: all, open, closed, members, organization, starred
  • fields - Comma-separated fields to include
Boards
Get Board
bash
GET /trello/1/boards/{id}

Query parameters:

  • fields - Comma-separated fields
  • lists - Include lists: all, open, closed, none
  • cards - Include cards: all, open, closed, none
  • members - Include members: all, none

Example:

bash
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
Create Board
bash
POST /trello/1/boards
Content-Type: application/json

{
  "name": "Project Alpha",
  "desc": "Main project board",
  "defaultLists": false,
  "prefs_permissionLevel": "private"
}
Update Board
bash
PUT /trello/1/boards/{id}
Content-Type: application/json

{
  "name": "Project Alpha - Updated",
  "desc": "Updated description"
}
Delete Board
bash
DELETE /trello/1/boards/{id}
Get Board Lists
bash
GET /trello/1/boards/{id}/lists

Query parameters:

  • filter - Filter: all, open, closed, none
Get Board Cards
bash
GET /trello/1/boards/{id}/cards
Get Board Members
bash
GET /trello/1/boards/{id}/members
Lists
Get List
bash
GET /trello/1/lists/{id}
Create List
bash
POST /trello/1/lists
Content-Type: application/json

{
  "name": "To Do",
  "idBoard": "BOARD_ID",
  "pos": "top"
}
Update List
bash
PUT /trello/1/lists/{id}
Content-Type: application/json

{
  "name": "In Progress"
}
Archive List
bash
PUT /trello/1/lists/{id}/closed
Content-Type: application/json

{
  "value": true
}
Get Cards in List
bash
GET /trello/1/lists/{id}/cards
Move All Cards in List
bash
POST /trello/1/lists/{id}/moveAllCards
Content-Type: application/json

{
  "idBoard": "BOARD_ID",
  "idList": "TARGET_LIST_ID"
}
Cards
Get Card
bash
GET /trello/1/cards/{id}

Query parameters:

  • fields - Comma-separated fields
  • members - Include members (true/false)
  • checklists - Include checklists: all, none
  • attachments - Include attachments (true/false)
Create Card
bash
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"]
}
Update Card
bash
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
}
Move Card to List
bash
PUT /trello/1/cards/{id}
Content-Type: application/json

{
  "idList": "NEW_LIST_ID",
  "pos": "top"
}
Delete Card
bash
DELETE /trello/1/cards/{id}
Add Comment to Card
bash
POST /trello/1/cards/{id}/actions/comments
Content-Type: application/json

{
  "text": "This is a comment"
}
Add Member to Card
bash
POST /trello/1/cards/{id}/idMembers
Content-Type: application/json

{
  "value": "MEMBER_ID"
}
Remove Member from Card
bash
DELETE /trello/1/cards/{id}/idMembers/{idMember}
Add Label to Card
bash
POST /trello/1/cards/{id}/idLabels
Content-Type: application/json

{
  "value": "LABEL_ID"
}
Checklists
Get Checklist
bash
GET /trello/1/checklists/{id}
Create Checklist
bash
POST /trello/1/checklists
Content-Type: application/json

{
  "idCard": "CARD_ID",
  "name": "Task Checklist"
}
Create Checklist Item
bash
POST /trello/1/checklists/{id}/checkItems
Content-Type: application/json

{
  "name": "Subtask 1",
  "pos": "bottom",
  "checked": false
}
Update Checklist Item
bash
PUT /trello/1/cards/{cardId}/checkItem/{checkItemId}
Content-Type: application/json

{
  "state": "complete"
}
Delete Checklist
bash
DELETE /trello/1/checklists/{id}
Labels
Get Board Labels
bash
GET /trello/1/boards/{id}/labels
Create Label
bash
POST /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)

Update Label
bash
PUT /trello/1/labels/{id}
Content-Type: application/json

{
  "name": "Critical",
  "color": "red"
}
Delete Label
bash
DELETE /trello/1/labels/{id}
Show full SKILL.md (234 more words)Show less
Search All
bash
GET /trello/1/search?query=keyword&modelTypes=cards,boards

Query parameters:

  • query - Search query (required)
  • modelTypes - Comma-separated: actions, boards, cards, members, organizations
  • board_fields - Fields to return for boards
  • card_fields - Fields to return for cards
  • cards_limit - Max cards to return (1-1000)

Code Examples

JavaScript
javascript
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'
    })
  }
);
Python
python
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"},
)

Notes

  • IDs are 24-character alphanumeric strings
  • Use me to reference the authenticated user
  • Dates are in ISO 8601 format
  • pos can be top, bottom, or a positive number
  • Card positions within lists are floating point numbers
  • Use fields parameter to limit returned data and improve performance
  • Archived items can be retrieved with filter=closed
  • IMPORTANT: When using curl commands, use curl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsing
  • IMPORTANT: When piping curl output to jq 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.

Error Handling

StatusMeaning
400Missing Trello connection or invalid request
401Invalid or missing Maton API key
404Board, list, or card not found
429Rate limited (10 req/sec per account)
4xx/5xxPassthrough error from Trello API
Troubleshooting: API Key Issues
  1. Check that the MATON_API_KEY environment variable is set:
bash
echo $MATON_API_KEY
  1. Verify the API key is valid by listing connections:
bash
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
Troubleshooting: Invalid App Name
  1. Ensure your URL path starts with trello. For example:
  • Correct: https://gateway.maton.ai/trello/1/members/me/boards
  • Incorrect: https://gateway.maton.ai/1/members/me/boards

Resources

© CraftOS-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skills/trello-api of CraftOS-dev/CraftBot.

  • SKILL.md
  • .clawhub/origin.json
  • LICENSE.txt
  • _meta.json

Open the folder on GitHubat commit b50970c

Compare with similar skills

Trello API next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Trello API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Trello API this skillCraftOS-dev/CraftBot392—~3.2kAutomated safety check: PassMIT
Active CampaignLeoYeAI/openclaw-master-skills2.2k—~4.1kAutomated safety check: PassMIT
Acuity SchedulingLeoYeAI/openclaw-master-skills2.2k—~4.1kAutomated safety check: PassMIT
BrevoLeoYeAI/openclaw-master-skills2.2k—~4.8kAutomated safety check: PassMIT
ClickfunnelsLeoYeAI/openclaw-master-skills2.2k—~4.2kAutomated safety check: PassMIT
ConfluenceLeoYeAI/openclaw-master-skills2.2k—~4.4kAutomated safety check: PassMIT

Similar skills

  • Active Campaign

    LeoYeAI/openclaw-master-skills

    ActiveCampaign API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Acuity Scheduling

    LeoYeAI/openclaw-master-skills

    Acuity Scheduling API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.1k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Brevo

    LeoYeAI/openclaw-master-skills

    Brevo API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.8k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Clickfunnels

    LeoYeAI/openclaw-master-skills

    ClickFunnels API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Confluence

    LeoYeAI/openclaw-master-skills

    Confluence API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Dropbox

    LeoYeAI/openclaw-master-skills

    Dropbox API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.3k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

More from CraftOS-dev/CraftBot

All 89 skills in this repo
  • Self Improvement

    CraftOS-dev/CraftBot

    Captures learnings, errors, and corrections to enable continuous improvement.

    392 GitHub starsUsed in 5 repos~4.9k tokens
    Auto-check passed
  • Bbc News

    CraftOS-dev/CraftBot

    Fetch and display BBC News stories from various sections and regions via RSS feeds.

    392 GitHub starsUsed in 2 repos~555 tokens
    Auto-check passed
  • Outlook

    CraftOS-dev/CraftBot

    Read, search, and manage Outlook emails and calendar via Microsoft Graph API.

    392 GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • Nano Banana Pro

    CraftOS-dev/CraftBot

    Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image).

    392 GitHub starsUsed in 6 repos~1.4k tokens
    Auto-check passed
  • Airweave

    CraftOS-dev/CraftBot

    Context retrieval layer for AI agents across users' applications.

    392 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Telegram Bot Manager

    CraftOS-dev/CraftBot

    Manage and configure Telegram bots for OpenClaw. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~836 tokensUpdated today
    Auto-check passed

Categories

Questions about Trello API

What does Trello API do?

Trello API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot. Trello API is an agent skill from CraftOS-dev/CraftBot. Trello API integration with managed OAuth.

When should I use Trello API?

Trello API fits situations like: users want to interact with Trello for project management; tasks that involve Microservices; tasks that involve Third-party API integration.

How do I install Trello API in Claude Code?

Run `npx skills add CraftOS-dev/CraftBot --skill trello-api -a claude-code`. Or copy the skill folder (skills/trello-api in CraftOS-dev/CraftBot) into .claude/skills/trello-api in your project. Claude Code loads it when a task matches its description.

How do I install Trello API in Codex?

Run `npx skills add CraftOS-dev/CraftBot --skill trello-api -a codex`. Or copy the skill folder (skills/trello-api in CraftOS-dev/CraftBot) into .agents/skills/trello-api in your project. Codex loads it when a task matches its description.

Can I use Trello API in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CraftOS-dev/CraftBot --skill trello-api -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/trello-api, .gemini/skills/trello-api, .github/skills/trello-api and .opencode/skills/trello-api in your project.

What does Trello API need to run?

Going by SKILL.md and its folder, Trello API needs the command-line tools its instructions call (python and curl) and credentials named MATON_API_KEY. Our summary lists: Python 3; A credential in MATON_API_KEY; A credential in YOUR_API_KEY. Compatibility (from SKILL.md): Requires network access and valid Maton API key.

Does Trello API access the network?

SKILL.md names 6 domains. In commands or code: gateway.maton.ai, ctrl.maton.ai and connect.maton.ai; the agent is likely to contact these when it follows the instructions. As links in the text: developer.atlassian.com, maton.ai and discord.com. This is read from the text; nothing was executed.

Is Trello API safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Trello API use?

Trello API is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Trello API use?

About 3.2k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Trello API?

Skills that share tags, products or a category with Trello API: Active Campaign (LeoYeAI/openclaw-master-skills, 2.2k stars), Acuity Scheduling (LeoYeAI/openclaw-master-skills, 2.2k stars), Brevo (LeoYeAI/openclaw-master-skills, 2.2k stars) and Clickfunnels (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Trello API?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

Source: CraftOS-dev/CraftBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.