1.7.2npm · atlassian-trello-mcp · current release
Observed 2026-09-04T05:02:35.392Z using mcpSecurity-inventory. Status: partial. Negotiated protocol: 2024-11-05.
{
"tools": {},
"resources": {},
"prompts": {}
}| Tool | Category | Annotations | Risk |
|---|---|---|---|
create_cardCreate a new card in a Trello list. Use this to add tasks, ideas, or items to your workflow.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"name": {
"type": "string",
"description": "Name/title of the card (what the task or item is about)"
},
"desc": {
"type": "string",
"description": "Optional detailed description of the card"
},
"idList": {
"type": "string",
"description": "ID of the list where the card will be created (you can get this from get_lists)"
},
"pos": {
"oneOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"enum": [
"top",
"bottom"
]
}
],
"description": "Position in the list: \"top\", \"bottom\", or specific number"
},
"due": {
"type": "string",
"format": "date-time",
"description": "Optional due date for the card (ISO 8601 format, e.g., \"2024-12-31T23:59:59Z\")"
},
"start": {
"type": "string",
"format": "date-time",
"description": "Optional start date for the card (ISO 8601 format, e.g., \"2024-12-01T09:00:00Z\")"
},
"idMembers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional array of member IDs to assign to the card"
},
"idLabels": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional array of label IDs to categorize the card"
}
},
"required": [
"name",
"idList"
]
} | — | — · — | — |
get_board_detailsGet information about a Trello board. IMPORTANT: Start with includeDetails=false (default) to get board metadata and lists only. Then use get_card or trello_get_list_cards to drill into specific cards. Only set includeDetails=true for small boards when you need a full overview.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
},
"includeDetails": {
"type": "boolean",
"description": "Include all cards in the response. Default: false. WARNING: produces very large responses on busy boards. Prefer fetching board without details first, then use trello_get_list_cards or get_card for specific data.",
"default": false
},
"descriptionMaxLength": {
"type": "number",
"minimum": 0,
"maximum": 10000,
"description": "Maximum length for card descriptions when includeDetails=true (0 to exclude). Default: 200",
"default": 200
},
"compact": {
"type": "boolean",
"description": "When includeDetails=true, return minimal card fields only (id, name, url, listId). Default: true.",
"default": true
}
},
"required": [
"boardId"
]
} | — | — · — | — |
get_cardGet detailed information about a specific Trello card, including its content, status, members, and attachments.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card to retrieve (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"includeDetails": {
"type": "boolean",
"description": "Include additional details like members, labels, checklists, and activity badges",
"default": false
}
},
"required": [
"cardId"
]
} | — | — · — | — |
get_listsGet all lists in a specific Trello board. Use this to see the workflow columns (like "To Do", "In Progress", "Done") in a board.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
},
"filter": {
"type": "string",
"enum": [
"all",
"open",
"closed"
],
"description": "Filter lists by status: \"open\" for active lists, \"closed\" for archived lists, \"all\" for both",
"default": "open"
}
},
"required": [
"boardId"
]
} | — | — · — | — |
list_boardsList all Trello boards accessible to the user. Use this to see all boards you have access to, or filter by status.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"filter": {
"type": "string",
"enum": [
"all",
"open",
"closed"
],
"description": "Filter boards by status: \"open\" for active boards, \"closed\" for archived boards, \"all\" for both",
"default": "open"
}
},
"required": []
} | — | — · — | — |
move_cardMove a card to a different list. Use this to change a card's workflow status (e.g., from "To Do" to "In Progress").Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card to move (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"idList": {
"type": "string",
"description": "ID of the destination list (you can get this from get_lists)"
},
"pos": {
"oneOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"enum": [
"top",
"bottom"
]
}
],
"description": "Position in the destination list: \"top\", \"bottom\", or specific number"
}
},
"required": [
"cardId",
"idList"
]
} | — | — · — | — |
trello_add_commentAdd a comment to a Trello card. Use this to add notes, updates, or discussions to cards.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card to add comment to (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"text": {
"type": "string",
"description": "Text content of the comment",
"minLength": 1
}
},
"required": [
"cardId",
"text"
]
} | — | — · — | — |
trello_add_label_to_cardAssign an existing label to a Trello card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID of the card to label"
},
"labelId": {
"type": "string",
"description": "ID of the label to add"
}
},
"required": [
"cardId",
"labelId"
]
} | — | — · — | — |
trello_add_member_to_cardAdd a member to a Trello card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card"
},
"memberId": {
"type": "string",
"description": "ID of the member to add to the card"
}
},
"required": [
"cardId",
"memberId"
]
} | — | — · — | — |
trello_archive_cardArchive or unarchive a Trello card. Set value to true to archive, false to unarchive.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card to archive/unarchive (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"value": {
"type": "boolean",
"description": "true to archive, false to unarchive"
}
},
"required": [
"cardId",
"value"
]
} | — | — · — | — |
trello_create_card_attachmentAttach a URL or local file to a Trello card. Provide either a url (for link attachments) or filePath (for file uploads from the local filesystem).Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"url": {
"type": "string",
"description": "URL to attach as a link (e.g. \"https://example.com/doc.pdf\"). Cannot be used with filePath."
},
"filePath": {
"type": "string",
"description": "Absolute path to a local file to upload (e.g. \"/home/user/report.pdf\"). Cannot be used with url."
},
"name": {
"type": "string",
"description": "Optional display name for the attachment"
},
"mimeType": {
"type": "string",
"description": "Optional MIME type (e.g. \"application/pdf\", \"image/png\"). Auto-detected for file uploads if omitted."
},
"setCover": {
"type": "boolean",
"description": "If true, set this attachment as the card cover image"
}
},
"required": [
"cardId"
]
} | — | — · — | — |
trello_create_check_itemAdd an item to a checklist. Supports due dates and member assignment.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist to add the item to"
},
"name": {
"type": "string",
"description": "Text of the check item",
"minLength": 1
},
"pos": {
"oneOf": [
{
"type": "string",
"enum": [
"top",
"bottom"
]
},
{
"type": "number",
"minimum": 0
}
],
"description": "Position: \"top\", \"bottom\", or a number"
},
"checked": {
"type": "boolean",
"description": "Whether the item should start as checked",
"default": false
},
"due": {
"type": "string",
"description": "Due date in ISO 8601 format (e.g., \"2024-12-31T23:59:59Z\")",
"format": "date-time"
},
"idMember": {
"type": "string",
"description": "ID of the member to assign"
}
},
"required": [
"checklistId",
"name"
]
} | — | — · — | — |
trello_create_checklistCreate a checklist on a card. Optionally copy items from an existing checklist.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID of the card to add the checklist to"
},
"name": {
"type": "string",
"description": "Name of the checklist",
"minLength": 1
},
"idChecklistSource": {
"type": "string",
"description": "Optional: ID of a checklist to copy items from"
},
"pos": {
"oneOf": [
{
"type": "string",
"enum": [
"top",
"bottom"
]
},
{
"type": "number",
"minimum": 0
}
],
"description": "Position of the checklist: \"top\", \"bottom\", or a positive number"
}
},
"required": [
"cardId",
"name"
]
} | — | — · — | — |
trello_create_labelCreate a new label on a Trello board.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board where the label will be created"
},
"name": {
"type": "string",
"description": "Name of the label",
"minLength": 1
},
"color": {
"type": "string",
"description": "Color of the label (e.g., green, yellow, orange, red, purple, blue, sky, lime, pink, black)"
}
},
"required": [
"boardId",
"name",
"color"
]
} | — | — · — | — |
trello_create_listCreate a new list in a Trello board. Use this to add workflow columns like "To Do", "In Progress", or "Done".Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"name": {
"type": "string",
"description": "Name of the new list (e.g., \"To Do\", \"In Progress\", \"Done\")",
"minLength": 1
},
"idBoard": {
"type": "string",
"description": "ID or URL of the board where the list will be created (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
},
"pos": {
"oneOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"enum": [
"top",
"bottom"
]
}
],
"description": "Position of the list in the board: \"top\", \"bottom\", or specific number",
"default": "bottom"
}
},
"required": [
"name",
"idBoard"
]
} | — | — · — | — |
trello_delete_card_attachmentDelete an attachment from a Trello card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"attachmentId": {
"type": "string",
"description": "ID of the attachment to delete"
}
},
"required": [
"cardId",
"attachmentId"
]
} | — | — · — | — |
trello_delete_check_itemDelete an item from a checklist.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist"
},
"checkItemId": {
"type": "string",
"description": "ID of the check item to delete"
}
},
"required": [
"checklistId",
"checkItemId"
]
} | — | — · — | — |
trello_delete_checklistDelete a checklist from a card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist to delete"
}
},
"required": [
"checklistId"
]
} | — | — · — | — |
trello_delete_commentPermanently delete a comment from a Trello card. Takes the action ID of the comment, the same "id" that trello_get_card_actions, trello_get_board_actions and trello_add_comment return for a commentCard action. Only comments can be deleted, and only ones written by the authenticated member. Trello offers no undo for this, so prefer trello_update_comment when the intent is to correct rather than remove.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"actionId": {
"type": "string",
"description": "ID of the comment action to delete (the \"id\" of a commentCard action, not the card ID)"
}
},
"required": [
"actionId"
]
} | — | — · — | — |
trello_delete_labelDelete a label from a Trello board.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"labelId": {
"type": "string",
"description": "ID of the label to delete"
}
},
"required": [
"labelId"
]
} | — | — · — | — |
trello_filter_listsFilter lists on a board by name. Returns lists whose name contains the filter string (case-insensitive).Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
},
"filter": {
"type": "string",
"description": "Search string to filter lists by name (case-insensitive)"
}
},
"required": [
"boardId",
"filter"
]
} | — | — · — | — |
trello_get_board_actionsGet activity history for a whole Trello board (card moves, renames, comments, creations, archivals). Supports since/before paging for incremental sync — use this rather than calling trello_get_card_actions once per card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
},
"filter": {
"type": "string",
"description": "Comma-separated action types to include (e.g. \"updateCard,commentCard,createCard\"), or \"all\"",
"default": "all"
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 1000,
"description": "Maximum number of actions to return per call",
"default": 50
},
"since": {
"type": "string",
"description": "Only return actions after this action ID or ISO date. Pass the ID of the newest action you already hold to fetch just what changed."
},
"before": {
"type": "string",
"description": "Only return actions before this action ID or ISO date. Use to page backwards through older history."
}
},
"required": [
"boardId"
]
} | — | — · — | — |
trello_get_board_cardsGet cards from a Trello board with optional filtering (by status or by assigned member) and detailed information like attachments and members.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
},
"attachments": {
"type": "string",
"enum": [
"cover",
"true",
"false"
],
"description": "Include attachment information: \"cover\" for cover images, \"true\" for all attachments",
"default": "false"
},
"members": {
"type": "string",
"enum": [
"true",
"false"
],
"description": "Include member information for each card. (This only toggles whether member details are returned; to filter cards by member, use the \"member\" parameter.)",
"default": "true"
},
"member": {
"type": "string",
"description": "Filter cards to only those assigned to this member. Accepts a member ID, username, or full name (case-insensitive). When set, member details are always fetched so matching can occur."
},
"filter": {
"type": "string",
"enum": [
"all",
"open",
"closed"
],
"description": "Filter cards by status",
"default": "open"
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 1000,
"description": "Maximum number of cards to return. Default: 50",
"default": 50
},
"descriptionMaxLength": {
"type": "number",
"minimum": 0,
"maximum": 10000,
"description": "Maximum length for descriptions (0 to exclude descriptions). Default: 200",
"default": 200
},
"compact": {
"type": "boolean",
"description": "Return minimal fields only (id, name, url, listId). Default: true. Set to false for full details.",
"default": true
}
},
"required": [
"boardId"
]
} | — | — · — | — |
trello_get_board_custom_fieldsGet all custom field definitions for a Trello board. Returns field names, types, and options.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board to get custom fields from"
}
},
"required": [
"boardId"
]
} | — | — · — | — |
trello_get_board_for_checklistGet the board that a checklist belongs to.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist"
}
},
"required": [
"checklistId"
]
} | — | — · — | — |
trello_get_board_labelsGet all labels available on a specific Trello board for categorizing cards.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
}
},
"required": [
"boardId"
]
} | — | — · — | — |
trello_get_board_membersGet all members who have access to a specific Trello board.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
}
},
"required": [
"boardId"
]
} | — | — · — | — |
trello_get_card_actionsGet activity history and comments for a specific Trello card. Useful for tracking changes and discussions.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"filter": {
"type": "string",
"enum": [
"all",
"commentCard",
"updateCard",
"createCard"
],
"description": "Filter actions by type: \"commentCard\" for comments only, \"updateCard\" for updates",
"default": "commentCard"
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 1000,
"description": "Maximum number of actions to return",
"default": 50
}
},
"required": [
"cardId"
]
} | — | — · — | — |
trello_get_card_attachmentGet details of a single attachment on a Trello card by its attachment ID.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"attachmentId": {
"type": "string",
"description": "ID of the attachment to retrieve"
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: specific fields to include (e.g., [\"name\", \"url\", \"mimeType\", \"date\"])"
}
},
"required": [
"cardId",
"attachmentId"
]
} | — | — · — | — |
trello_get_card_attachmentsGet all attachments (files, links) for a specific Trello card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: specific fields to include (e.g., [\"name\", \"url\", \"mimeType\", \"date\"])"
}
},
"required": [
"cardId"
]
} | — | — · — | — |
trello_get_card_by_numberFind a card on a board by its board-local number, the "#N" Trello shows on the card (its idShort). Use this to resolve a number a person quoted, such as "card #168", into a real card without needing its ID or URL. Card numbers are unique within a board but not across boards, so the board must be given.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"boardId": {
"type": "string",
"description": "ID or URL of the board the card is on (e.g. \"abc123\" or \"https://trello.com/b/abc123/board-name\")"
},
"cardNumber": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
],
"description": "The board-local card number, e.g. 168 for the card shown as \"#168\""
}
},
"required": [
"boardId",
"cardNumber"
]
} | — | — · — | — |
trello_get_card_checklistsGet all checklists and their items for a specific Trello card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"checkItems": {
"type": "string",
"enum": [
"all",
"none"
],
"description": "Include checklist items in response",
"default": "all"
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: specific fields to include (e.g., [\"name\", \"pos\"])"
}
},
"required": [
"cardId"
]
} | — | — · — | — |
trello_get_card_for_checklistGet the card that a checklist belongs to.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist"
}
},
"required": [
"checklistId"
]
} | — | — · — | — |
trello_get_check_itemGet a single check item from a checklist.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist"
},
"checkItemId": {
"type": "string",
"description": "ID of the check item"
}
},
"required": [
"checklistId",
"checkItemId"
]
} | — | — · — | — |
trello_get_check_itemsGet all items on a checklist. Supports filtering by state (all, complete, incomplete).Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist"
},
"filter": {
"type": "string",
"enum": [
"all",
"complete",
"incomplete"
],
"description": "Filter items by state. Default: all",
"default": "all"
}
},
"required": [
"checklistId"
]
} | — | — · — | — |
trello_get_checklistGet a single checklist with its check items.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist"
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: specific fields to include"
}
},
"required": [
"checklistId"
]
} | — | — · — | — |
trello_get_checklist_fieldGet a specific field (name or pos) from a checklist.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist"
},
"field": {
"type": "string",
"enum": [
"name",
"pos"
],
"description": "Field to retrieve"
}
},
"required": [
"checklistId",
"field"
]
} | — | — · — | — |
trello_get_list_cardsGet all cards in a specific Trello list. Use this to see all tasks/items in a workflow column.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"listId": {
"type": "string",
"description": "ID of the list to get cards from (you can get this from get_lists)"
},
"filter": {
"type": "string",
"enum": [
"all",
"open",
"closed"
],
"description": "Filter cards by status: \"open\" for active cards, \"closed\" for archived cards, \"all\" for both",
"default": "open"
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: specific fields to include (e.g., [\"name\", \"desc\", \"due\", \"labels\", \"members\"])"
},
"compact": {
"type": "boolean",
"description": "Return minimal fields only (id, name, url, listId). Default: true. Set to false for full details.",
"default": true
}
},
"required": [
"listId"
]
} | — | — · — | — |
trello_get_memberGet details about a specific Trello member/user, including their boards and profile information.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"memberId": {
"type": "string",
"description": "ID or username of the member to retrieve (use \"me\" for current user)",
"pattern": "^[A-Za-z0-9_-]{1,64}$"
},
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: specific fields to include (e.g., [\"fullName\", \"username\", \"bio\", \"url\"])"
},
"boards": {
"type": "string",
"enum": [
"all",
"open",
"closed",
"none"
],
"description": "Include member's boards in response",
"default": "open"
},
"organizations": {
"type": "string",
"enum": [
"all",
"none"
],
"description": "Include member's organizations in response",
"default": "all"
}
},
"required": [
"memberId"
]
} | — | — · — | — |
trello_get_user_boardsGet all boards accessible to the current user. This is the starting point for exploring your Trello workspace.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"filter": {
"type": "string",
"enum": [
"all",
"open",
"closed"
],
"description": "Filter boards by status: \"open\" for active boards, \"closed\" for archived boards, \"all\" for both",
"default": "open"
}
},
"required": []
} | — | — · — | — |
trello_remove_label_from_cardRemove a label from a Trello card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID of the card to remove the label from"
},
"labelId": {
"type": "string",
"description": "ID of the label to remove"
}
},
"required": [
"cardId",
"labelId"
]
} | — | — · — | — |
trello_remove_member_from_cardRemove a member from a Trello card.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card"
},
"memberId": {
"type": "string",
"description": "ID of the member to remove from the card"
}
},
"required": [
"cardId",
"memberId"
]
} | — | — · — | — |
trello_searchUniversal search across all Trello content (boards, cards, members). Use this to find specific items by keywords or phrases.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"query": {
"type": "string",
"description": "Search term or phrase to find in Trello content",
"minLength": 1
},
"modelTypes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"boards",
"cards",
"members",
"organizations"
]
},
"description": "Types of content to search in. Defaults to all types if not specified",
"default": [
"boards",
"cards",
"members"
]
},
"boardIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: limit search to specific boards by their IDs or URLs"
},
"boardsLimit": {
"type": "number",
"minimum": 1,
"maximum": 1000,
"description": "Maximum number of boards to return in results",
"default": 10
},
"cardsLimit": {
"type": "number",
"minimum": 1,
"maximum": 1000,
"description": "Maximum number of cards to return in results",
"default": 50
},
"membersLimit": {
"type": "number",
"minimum": 1,
"maximum": 1000,
"description": "Maximum number of members to return in results",
"default": 20
},
"descriptionMaxLength": {
"type": "number",
"minimum": 0,
"maximum": 10000,
"description": "Maximum length for descriptions (0 to exclude descriptions). Default: 200",
"default": 200
},
"compact": {
"type": "boolean",
"description": "Return minimal fields only (id, name, url). Default: true. Set to false for full details.",
"default": true
}
},
"required": [
"query"
]
} | — | — · — | — |
trello_update_check_itemUpdate a check item on a card (name, state, position, due date, member). Use state to check/uncheck items.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID of the card the check item belongs to"
},
"checkItemId": {
"type": "string",
"description": "ID of the check item to update"
},
"name": {
"type": "string",
"description": "New name for the check item"
},
"state": {
"type": "string",
"enum": [
"complete",
"incomplete"
],
"description": "Set to \"complete\" to check or \"incomplete\" to uncheck"
},
"pos": {
"oneOf": [
{
"type": "string",
"enum": [
"top",
"bottom"
]
},
{
"type": "number",
"minimum": 0
}
],
"description": "New position"
},
"due": {
"type": [
"string",
"null"
],
"description": "Due date (ISO 8601) or null to remove"
},
"idMember": {
"type": [
"string",
"null"
],
"description": "Member ID to assign or null to unassign"
}
},
"required": [
"cardId",
"checkItemId"
]
} | — | — · — | — |
trello_update_checklistUpdate a checklist name or position.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist to update"
},
"name": {
"type": "string",
"description": "New name for the checklist"
},
"pos": {
"oneOf": [
{
"type": "string",
"enum": [
"top",
"bottom"
]
},
{
"type": "number",
"minimum": 0
}
],
"description": "New position"
}
},
"required": [
"checklistId"
]
} | — | — · — | — |
trello_update_checklist_fieldUpdate a specific field (name or pos) on a checklist.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"checklistId": {
"type": "string",
"description": "ID of the checklist"
},
"field": {
"type": "string",
"enum": [
"name",
"pos"
],
"description": "Field to update"
},
"value": {
"type": "string",
"description": "New value for the field"
}
},
"required": [
"checklistId",
"field",
"value"
]
} | — | — · — | — |
trello_update_commentEdit the text of an existing comment on a Trello card. Takes the action ID of the comment, which is the "id" field that trello_get_card_actions and trello_get_board_actions return for a commentCard action, and that trello_add_comment returns when the comment is created. Only comments can be edited, and only ones written by the authenticated member.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"actionId": {
"type": "string",
"description": "ID of the comment action to edit (the \"id\" of a commentCard action, not the card ID)"
},
"text": {
"type": "string",
"description": "The replacement comment text. This overwrites the comment entirely rather than appending to it.",
"minLength": 1,
"maxLength": 16384
}
},
"required": [
"actionId",
"text"
]
} | — | — · — | — |
trello_update_labelUpdate the name or color of an existing Trello label.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"labelId": {
"type": "string",
"description": "ID of the label to update"
},
"name": {
"type": "string",
"description": "New name for the label",
"minLength": 1
},
"color": {
"type": "string",
"description": "New color for the label"
}
},
"required": [
"labelId"
]
} | — | — · — | — |
trello_update_listUpdate an existing Trello list: rename it, archive or unarchive it, move it to a different position on the board, or change subscription. Use this instead of deleting and recreating a list, which loses its cards.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"listId": {
"type": "string",
"description": "ID or URL of the list to update"
},
"name": {
"type": "string",
"description": "New name for the list",
"minLength": 1
},
"closed": {
"type": "boolean",
"description": "Set true to archive the list, false to restore it to the board"
},
"pos": {
"oneOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string"
}
],
"description": "New position on the board: \"top\", \"bottom\", or a specific number"
},
"subscribed": {
"type": "boolean",
"description": "Whether the authenticated member is subscribed to the list"
}
},
"required": [
"listId"
]
} | — | — · — | — |
update_cardUpdate properties of an existing Trello card. Use this to change card details like name, description, due date, or status.Input schema{
"type": "object",
"properties": {
"apiKey": {
"type": "string",
"description": "Trello API key (optional if TRELLO_API_KEY env var is set)"
},
"token": {
"type": "string",
"description": "Trello API token (optional if TRELLO_TOKEN env var is set)"
},
"cardId": {
"type": "string",
"description": "ID or URL of the card to update (e.g. \"abc123\" or \"https://trello.com/c/abc123/1-title\")"
},
"name": {
"type": "string",
"description": "New name/title for the card"
},
"desc": {
"type": "string",
"description": "New description for the card"
},
"closed": {
"type": "boolean",
"description": "Set to true to archive the card, false to unarchive"
},
"due": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Set due date (ISO 8601 format) or null to remove due date"
},
"dueComplete": {
"type": "boolean",
"description": "Mark the due date as complete (true) or incomplete (false)"
},
"start": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "Set start date (ISO 8601 format) or null to remove start date"
},
"idList": {
"type": "string",
"description": "Move card to a different list by providing the list ID"
},
"pos": {
"oneOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "string",
"enum": [
"top",
"bottom"
]
}
],
"description": "Change position in the list: \"top\", \"bottom\", or specific number"
}
},
"required": [
"cardId"
]
} | — | — · — | — |