Focalboard MCP Server

Instructions

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`);
  }