create-list
Add a new list to a Trello board by specifying the board ID, list name, and optional position to organize project tasks.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| boardId | Yes | ID of the board to create the list in | |
| name | Yes | Name of the list | |
| position | No | Position of the list (e.g. "top", "bottom", or a number) |
Implementation Reference
- src/tools/lists.ts:52-101 (handler)Handler function that creates a new Trello list using POST /lists endpoint with provided boardId, name, and optional position.async ({ boardId, name, position = 'bottom' }) => { try { if (!credentials.apiKey || !credentials.apiToken) { return { content: [ { type: 'text', text: 'Trello API credentials are not configured', }, ], isError: true, }; } const response = await fetch( `https://api.trello.com/1/lists?key=${credentials.apiKey}&token=${credentials.apiToken}`, { method: 'POST', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ name, idBoard: boardId, pos: position, }), } ); const data = await response.json(); return { content: [ { type: 'text', text: JSON.stringify(data), }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Error creating list: ${error}`, }, ], isError: true, }; } } );
- src/tools/lists.ts:47-51 (schema)Input schema using Zod for validating parameters: boardId, name, and optional position.{ boardId: z.string().describe('ID of the board to create the list in'), name: z.string().describe('Name of the list'), position: z.string().optional().describe('Position of the list (e.g. "top", "bottom", or a number)'), },
- src/tools/lists.ts:46-101 (registration)The server.tool() call within registerListsTools that registers the 'create-list' tool, including schema and handler.'create-list', { boardId: z.string().describe('ID of the board to create the list in'), name: z.string().describe('Name of the list'), position: z.string().optional().describe('Position of the list (e.g. "top", "bottom", or a number)'), }, async ({ boardId, name, position = 'bottom' }) => { try { if (!credentials.apiKey || !credentials.apiToken) { return { content: [ { type: 'text', text: 'Trello API credentials are not configured', }, ], isError: true, }; } const response = await fetch( `https://api.trello.com/1/lists?key=${credentials.apiKey}&token=${credentials.apiToken}`, { method: 'POST', headers: { 'Content-Type': 'application/json', }, body: JSON.stringify({ name, idBoard: boardId, pos: position, }), } ); const data = await response.json(); return { content: [ { type: 'text', text: JSON.stringify(data), }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Error creating list: ${error}`, }, ], isError: true, }; } } );
- src/index.ts:89-89 (registration)Invocation of registerListsTools in the main server setup, which registers all list tools including 'create-list'.registerListsTools(server, credentials);