96b0f9632d7954a9fc5fcce3542d164803d5cdcesource_git · axgrid/trello-mcp · current release
Observed 2026-08-25T22:33:11.285Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.
{
"tools": {}
}| Tool | Category | Annotations | Risk |
|---|---|---|---|
add_commentPost a comment to a card (useful for asking a clarifying question or logging progress while solving a task).Input schema{
"type": "object",
"properties": {
"card": {
"type": "string",
"description": "Card id, shortLink, or URL."
},
"text": {
"type": "string",
"description": "Comment body (Markdown supported)."
}
},
"required": [
"card",
"text"
],
"additionalProperties": false
} | — | — · — | — |
attach_fileAttach a file to a card — a local file by `path`, or a remote file by `url`. Handy for posting a result file when finishing a task.Input schema{
"type": "object",
"properties": {
"card": {
"type": "string",
"description": "Card id, shortLink, or URL."
},
"path": {
"type": "string",
"description": "Absolute path to a local file to upload."
},
"url": {
"type": "string",
"description": "URL of a remote file to attach (instead of path)."
},
"name": {
"type": "string",
"description": "Optional display name for the attachment."
},
"mimeType": {
"type": "string",
"description": "Optional MIME type for an uploaded local file."
}
},
"required": [
"card"
],
"additionalProperties": false
} | — | — · — | — |
find_cardsFind cards on a board, optionally filtered by a custom field value, list name, and/or label. This is the main tool: e.g. fieldName='AI Ready', value='Claude kiosk'. Use `values` to match ANY of several values at once, e.g. ['Claude kiosk','Claude Module'] to pull the whole queue, or ['Need response'] to see what's waiting on a human. Matching is case-insensitive (exact first, then substring). Omit value/values to match cards where the field is simply set.Input schema{
"type": "object",
"properties": {
"board": {
"type": "string",
"description": "Board id, shortLink, URL, or unique name."
},
"fieldName": {
"type": "string",
"description": "Custom field name to filter by, e.g. 'AI Ready'."
},
"value": {
"type": "string",
"description": "A single desired value of the custom field, e.g. 'Claude kiosk'."
},
"values": {
"type": "array",
"items": {
"type": "string"
},
"description": "Several values; a card matches if it has ANY of them (combined with `value`)."
},
"listName": {
"type": "string",
"description": "Optional: only cards whose list name contains this."
},
"label": {
"type": "string",
"description": "Optional: only cards with this label name or color."
}
},
"required": [
"board"
],
"additionalProperties": false
} | — | — · — | — |
get_cardGet the full content of one card: description, custom field values, checklists, attachments, comments, members, due date.Input schema{
"type": "object",
"properties": {
"card": {
"type": "string",
"description": "Card id, 8-char shortLink, or card URL."
}
},
"required": [
"card"
],
"additionalProperties": false
} | — | — · — | — |
list_boardsList all Trello boards you can access. Returns compact {id, name, shortLink, url} — use this instead of dumping full board JSON.Input schema{
"type": "object",
"properties": {},
"additionalProperties": false
} | — | — · — | — |
list_custom_fieldsList the custom fields defined on a board, including the allowed options for list-type fields. Use this to discover field names and values before calling find_cards.Input schema{
"type": "object",
"properties": {
"board": {
"type": "string",
"description": "Board id, 8-char shortLink, board URL, or (unique) name."
}
},
"required": [
"board"
],
"additionalProperties": false
} | — | — · — | — |
set_custom_fieldSet (or clear) a custom field on a card — e.g. mark a task done by setting AI Ready to 'Done'. For list-type fields the value is matched to an existing option; pass createOption:true to add a new option. Leave value empty to clear the field.Input schema{
"type": "object",
"properties": {
"card": {
"type": "string",
"description": "Card id, shortLink, or URL."
},
"field": {
"type": "string",
"description": "Custom field name, e.g. 'AI Ready'."
},
"value": {
"type": "string",
"description": "Value to set. Empty/omitted clears the field."
},
"createOption": {
"type": "boolean",
"description": "For list fields: create the option if it doesn't exist yet (default false)."
}
},
"required": [
"card",
"field"
],
"additionalProperties": false
} | — | — · — | — |