list_boards
Retrieve all boards for a specific team with their IDs, titles, and properties to organize and access project workspaces.
Instructions
List all boards for a team. Returns an array of boards with their IDs, titles, and properties.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| teamId | No | The team ID to list boards for (default: "0" for default team) | 0 |
Implementation Reference
- src/index.ts:263-274 (handler)MCP tool execution handler for 'list_boards'. Extracts teamId from input arguments (default '0'), calls focalboard.listBoards(), and returns the boards as a JSON-formatted text content block.case 'list_boards': { const teamId = (args?.teamId as string) || '0'; const boards = await focalboard.listBoards(teamId); return { content: [ { type: 'text', text: JSON.stringify(boards, null, 2) } ] }; }
- src/index.ts:32-45 (registration)Registration of the 'list_boards' tool in the MCP server's tools list, including name, description, and inputSchema definition.{ name: 'list_boards', description: 'List all boards for a team. Returns an array of boards with their IDs, titles, and properties.', inputSchema: { type: 'object', properties: { teamId: { type: 'string', description: 'The team ID to list boards for (default: "0" for default team)', default: '0' } } } },
- src/index.ts:35-44 (schema)Input schema definition for the 'list_boards' tool, specifying optional teamId parameter with default '0'.inputSchema: { type: 'object', properties: { teamId: { type: 'string', description: 'The team ID to list boards for (default: "0" for default team)', default: '0' } } }
- src/focalboard-client.ts:151-153 (helper)Core helper function in FocalboardClient that performs the API request to fetch boards for the given teamId via makeRequest method.async listBoards(teamId: string = '0'): Promise<Board[]> { return this.makeRequest<Board[]>(`/teams/${teamId}/boards`); }