list_boards
Retrieve all boards for a team to view their IDs, titles, and properties for task management.
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 handler for 'list_boards': extracts teamId from input arguments (default '0'), calls focalboard.listBoards(), and returns the boards as JSON-formatted text content.
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 tools array, including name, description, and input schema definition. This array is used by the MCP server for ListToolsRequest.
{ 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 for the 'list_boards' tool defining the optional teamId parameter.
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 method in FocalboardClient that performs the authenticated API GET request to /teams/{teamId}/boards to fetch the list of boards.
async listBoards(teamId: string = '0'): Promise<Board[]> { return this.makeRequest<Board[]>(`/teams/${teamId}/boards`); }