trello-mcp-server

Implementation Reference

• src/tools/card-tool-handlers.ts:29-32 (handler)

  The asynchronous handler function for the "create_card" tool. It uses ServiceFactory to get the CardService instance and calls its createCard method with the provided arguments to execute the tool logic.
  create_card: async (args: any) => { const cardService = ServiceFactory.getInstance().getCardService(); return cardService.createCard(args); },
• src/tools/card-tools.ts:35-102 (schema)

  The JSON Schema defining the input parameters for the "create_card" tool, specifying required fields (name, idList) and optional properties like description, position, due date, members, labels, etc.
  inputSchema: { type: "object", properties: { name: { type: "string", description: "Name of the card" }, idList: { type: "string", description: "ID of the list the card should belong to" }, desc: { type: "string", description: "Description of the card" }, pos: { type: ["string", "number"], description: "Position of the card (top, bottom, or a positive number)" }, due: { type: ["string", "null"], description: "Due date for the card (ISO-8601 format, e.g., 2023-12-31T12:00:00Z)" }, start: { type: ["string", "null"], description: "Start date for the card (ISO-8601 format, e.g., 2023-12-31T12:00:00Z)" }, dueComplete: { type: "boolean", description: "Whether the due date is complete" }, idMembers: { type: "array", items: { type: "string" }, description: "IDs of members to assign to the card" }, idLabels: { type: "array", items: { type: "string" }, description: "IDs of labels to add to the card" }, urlSource: { type: "string", description: "URL to attach to the card" }, idCardSource: { type: "string", description: "ID of a card to copy from" }, keepFromSource: { type: "string", description: "What to copy from the source card (all or a comma-separated list of: attachments, checklists, comments, due, labels, members, stickers)" }, address: { type: "string", description: "Address for the card" }, locationName: { type: "string", description: "Location name for the card" }, coordinates: { type: "string", description: "Coordinates for the card (latitude,longitude)" } }, required: ["name", "idList"] }
• src/tools/card-tools.ts:32-102 (registration)

  The tool registration object in cardTools array, defining the name, description, and input schema for the "create_card" tool, which is later aggregated into trelloTools.
  { name: "create_card", description: "Create a new card on a list. Use this tool when you need to add a new card to a list.", inputSchema: { type: "object", properties: { name: { type: "string", description: "Name of the card" }, idList: { type: "string", description: "ID of the list the card should belong to" }, desc: { type: "string", description: "Description of the card" }, pos: { type: ["string", "number"], description: "Position of the card (top, bottom, or a positive number)" }, due: { type: ["string", "null"], description: "Due date for the card (ISO-8601 format, e.g., 2023-12-31T12:00:00Z)" }, start: { type: ["string", "null"], description: "Start date for the card (ISO-8601 format, e.g., 2023-12-31T12:00:00Z)" }, dueComplete: { type: "boolean", description: "Whether the due date is complete" }, idMembers: { type: "array", items: { type: "string" }, description: "IDs of members to assign to the card" }, idLabels: { type: "array", items: { type: "string" }, description: "IDs of labels to add to the card" }, urlSource: { type: "string", description: "URL to attach to the card" }, idCardSource: { type: "string", description: "ID of a card to copy from" }, keepFromSource: { type: "string", description: "What to copy from the source card (all or a comma-separated list of: attachments, checklists, comments, due, labels, members, stickers)" }, address: { type: "string", description: "Address for the card" }, locationName: { type: "string", description: "Location name for the card" }, coordinates: { type: "string", description: "Coordinates for the card (latitude,longitude)" } }, required: ["name", "idList"] }
• src/services/card-service.ts:48-50 (helper)

  The helper method in CardService that implements the card creation by posting to Trello's /cards API endpoint using TrelloService.
  async createCard(data: CreateCardData): Promise<TrelloCard> { return this.trelloService.post<TrelloCard>('/cards', data); }