search_boards
Find boards by name or keyword within a specific team to quickly locate relevant project boards and workspaces for efficient task management.
Instructions
Search for boards by name or keyword within a team.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| teamId | No | The team ID to search within (default: "0" for default team) | 0 |
| searchTerm | Yes | The search term to find boards |
Implementation Reference
- src/index.ts:292-307 (handler)MCP tool handler for 'search_boards' that validates input, calls focalboard.searchBoards, and returns JSON-formatted results.case 'search_boards': { const teamId = (args?.teamId as string) || '0'; const searchTerm = args?.searchTerm as string; if (!searchTerm) { throw new Error('searchTerm is required'); } const boards = await focalboard.searchBoards(teamId, searchTerm); return { content: [ { type: 'text', text: JSON.stringify(boards, null, 2) } ] }; }
- src/index.ts:60-78 (registration)Tool registration in the MCP tools list, defining name, description, and input schema.{ name: 'search_boards', description: 'Search for boards by name or keyword within a team.', inputSchema: { type: 'object', properties: { teamId: { type: 'string', description: 'The team ID to search within (default: "0" for default team)', default: '0' }, searchTerm: { type: 'string', description: 'The search term to find boards' } }, required: ['searchTerm'] } },
- src/focalboard-client.ts:165-172 (helper)Core implementation of board search in FocalboardClient via API call to /teams/{teamId}/boards/search.async searchBoards(teamId: string, term: string): Promise<Board[]> { return this.makeRequest<Board[]>( `/teams/${teamId}/boards/search`, 'GET', undefined, { q: term } ); }